home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 6 / The Arsenal Files 6 (Arsenal Computer).ISO / spitfire / sfrom22b.zip / SFROM.DOC < prev    next >
Text File  |  1996-01-14  |  110KB  |  2,239 lines
  1.  
  2.                               SF-ROM DOOR
  3.                              Version  2.20
  4.                          Released Jan 14, 1996
  5.  
  6.                 Copyright 1992-1996 by Michael Robinson
  7.                      Internet: TheMikeRob@aol.com
  8.  
  9.                           The Soft Parade BBS
  10.                         Shelton, Connecticut, USA
  11.                         1:141/485    203-924-5603
  12.                         1:141/486    203-922-1794
  13.               Fast Online registration using Visa/Mastercard
  14.  
  15.       SF-ROM is a file download door designed for Spitfire 3.x BBS.
  16.       It supports a plain UART, FOSSIL driver, or DigiBoard. X/Y/Zmodem
  17.       internal protocols. Files may be located on CD-ROM disk or magnetic
  18.       disk. Now supports Spitfire 3.00 to 3.51.
  19.  
  20.       Features include: up to 228 disks, up to 700 file areas per disk,
  21.       maintains it's own user/download database, requests from offline
  22.       disks, disk volume name detection, automatic menu creation,
  23.       create/download file lists, full multi-node and network support,
  24.       batch downloads from within the door, file tagging, fast text search
  25.       single or all disks, ZIP and text file viewer, insertion of BBS ads
  26.       into ZIP files, multi-disk changer support, automatic request
  27.       manager/editor program, user manager/editor program, configurable
  28.       user limits, chat mode, local drop to DOS, and DESQview aware. Can
  29.       be run in local copy-to-hardrive mode in the BBS or from the DOS
  30.       command line.
  31.  
  32.       A plain ASCII text file list is used for each file area. These lists
  33.       are often supplied on the CD-ROM disk and can be used with little or
  34.       no modification. Special compiled file lists are NOT required. SF-ROM
  35.       automatically supports multi-line file descriptions and it works
  36.       especially well with Night Owl and Spitfire format multi-line lists.
  37.       Optional formatting commands can be used to change the display
  38.       position on each line of the filename, size, date, and description.
  39.       Configurable display color too.
  40.  
  41.       SF-ROM is unique among CD-ROM doors because it maintains it's own
  42.       separate DATABASE to record caller download information and limit the
  43.       number of files/bytes downloaded and requested. It also records
  44.       files/bytes downloaded in SFFILE.DAT (or equivalent) which is read
  45.       back by Spitfire and recorded in the main Spitfire database.
  46.  
  47.       SF-ROM can also serve as a very configurable menu extension. From the
  48.       same main menu a caller can choose from a selection of CD-ROM disks,
  49.       magnetic disk file areas, and external doors. These may be used in
  50.       any combination. When an external door is chosen, SF-ROM exits with
  51.       an ErrorLevel which is then used in a batch file to pass control to
  52.       the selected external door.
  53.  
  54.       There is special support designed in for multiple nodes and/or
  55.       multiple CD-ROM drives such as the Pioneer DRM series disk changers.
  56.       SF-ROM acts as a traffic cop to control access, avoid collisions,
  57.       and prevent "thrashing" that can sometimes occur when multiple
  58.       users try to access the same drive.
  59.  
  60.       Considerable time and energy was spent working around the speed
  61.       limitations of today's CD-ROM drives. Actual CD-ROM drive hardware
  62.       access time has been minimized by:
  63.  
  64.       1. Maintaining the file lists on the magnetic drive. This is
  65.          optional. If the CD-ROM itself contains file lists, these can be
  66.          be accessed directly by the door in order to save hard drive
  67.          space. The same file lists may be shared by all nodes.
  68.       2. Copying the file to a holding directory on the hard drive and
  69.          downloading it from there. This is also optional. You can
  70.          configure the door to download directly from the CD-ROM drive.
  71.       3. Careful design of the door logic. The CD-ROM drive hardware is
  72.          accessed as rapidly as possible and only when absolutely required.
  73.       4. When files are copied from multiple disks, each disk is only
  74.          accessed once even if the caller did not select the files in
  75.          order by disk.
  76.  
  77.       FEATURES LIST:
  78.  
  79.       ■ Up to 228 disks. Up to 700 file areas per disk.
  80.  
  81.       ■ Direct support for plain UART, FOSSIL, or DigiBoard.
  82.  
  83.       ■ Batch downloads from within door using internal protocols:
  84.         Xmodem, Ymodem or Zmodem. Zmodem includes crash recovery of
  85.         aborted downloads and transmits total batch download statistics
  86.         to the file receiver.
  87.  
  88.       ■ File tagging while listing and while searching.
  89.  
  90.       ■ Fast text search of a file area, a whole disk, or all disks.
  91.  
  92.       ■ Online ZIP file and text file viewer.
  93.  
  94.       ■ Maintains it's own user/download database file that limits daily
  95.         downloads and requests on ANY BBS type. (registered version)
  96.         Configurable limits based on security level, files, bytes, ratios.
  97.         Includes EZ-User - Database Manager/Editor program.
  98.  
  99.       ■ Requests from offline disks. (registered version)
  100.         Includes EZ-Request - Automatic Request Manager/Editor program.
  101.         This program prompts the sysop to insert a disk into the drive, and
  102.         then copies all pending requests for that disk before prompting for
  103.         the next disk. Caller receives a message when entering the door if
  104.         requested files are ready for download. If successfully downloaded,
  105.         the files are deleted when the caller exits the door. If the caller
  106.         does not download the files, they are held for a configurable
  107.         number of days and then deleted.
  108.  
  109.       ■ Disk Detection. Reads volume name of the disk in the drive and sets
  110.         disk online status. Once configured, you can simply swap disks and
  111.         make NO changes to any config files. SF-ROM will do the rest. It
  112.         will read the volume name, set the correct status for each disk,
  113.         and display the status in the menu display.
  114.  
  115.       ■ AutoMenu. Constructs the main disk selection menu of all disks
  116.         on-the-fly. SF-ROM will create and display the main menu which
  117.         indicates which disks are online, request, or offline. Or you can
  118.         create your own custom ANSI/ASCII menu screens MAIN.CLR & MAIN.BBS.
  119.  
  120.       ■ Automatic file list creation and download. Can construct,
  121.         optionally ZIP, and send a list of all files on a disk. It
  122.         constructs this list on-the-fly by reading the configuration files.
  123.         Fully automatic. Built-in ZIP function, does not require PKZIP.
  124.  
  125.       ■ Inserts BBS advertisements into ZIP files. (registered version)
  126.         Uses optional batch file execution before and/or after download.
  127.  
  128.       ■ Special support for multi-disk changers such as Pioneer and NEC.
  129.         Prevents changer "collisions" on multi-node systems.
  130.  
  131.       ■ File sharing and locking for multinode and network operation. All
  132.         file lists, menus, data files and logs may be shared.
  133.  
  134.       ■ Communication port speeds to 115,200 bps with hardware or software
  135.         flow control. Automatically reads the communication port hardware
  136.         (UART) to determine port speed, data bits, stop bits and parity.
  137.         Port number to use is read from SFFILE.DAT. IRQ number and IO base
  138.         address to use is read from SFNODE.DAT. Port number, IRQ number,
  139.         and IO base address can also be set manually to handle non-standard
  140.         ports. Handles any UART, including the 16550AFN.
  141.  
  142.       ■ The door will recognize caller connect speeds from 0 to 230,400
  143.         bits per second. It will use the value passed by Spitfire in
  144.         SFFILE.DAT line 5 to calculate the estimated download times. Note
  145.         that sometimes this value is incorrect. Some modems connect at
  146.         12000, 14400, 16800, 19200, 21600, 24000, 26400, 28800, but "lie"
  147.         and tell Spitfire that the connect is 9600 or some other value.
  148.         The door automatically factors in a speed increase due to error
  149.         correction.
  150.  
  151.       ■ DESQview aware. Releases time slices (clock tics) to tasks
  152.         running in other windows when SF-ROM is idle.
  153.  
  154.       ■ ANSI color or plain ASCII text modes. Initial mode is the same as
  155.         passed by Spitfire. Caller can toggle ANSI on/off from within the
  156.         door. Door contains its own ANSI driver and can show ANSI graphics
  157.         on the local screen even if DOS ANSI.SYS is not loaded.
  158.  
  159.       ■ Sysops can design their own (optional) custom screens. Door will
  160.         display WELCOME.CLR or WELCOME.BBS before it runs. (registered
  161.         version) Place these in the same directory as SFROM.EXE. If ANSI is
  162.         on then the .CLR file will be shown, otherwise the .BBS file will
  163.         be shown.
  164.  
  165.       ■ Chat Mode
  166.       ■ Local drop to DOS
  167.       ■ Carrier detection. Resets the BBS if caller drops carrier.
  168.       ■ Inactivity timeout configurable from 1 to 10 minutes.
  169.       ■ Detailed caller info status lines can be located on the top or
  170.         bottom of the local screen.
  171.       ■ Detailed status screen displayed during download.
  172.       ■ Custom display screens.
  173.       ■ Optional logoff after transfer.
  174.       ■ Optional time penalty for dropped carrier.
  175.       ■ Logging of all caller activities to any file. (registered version)
  176.       ■ Sysop local keyboard controls same as Spitfire.
  177.  
  178.       SF-ROM is shareware with a $30 registration. See the end of this file
  179.       or REGISTER.DOC for registration form and information.
  180.  
  181.  
  182. ----- SETUP INSTRUCTIONS ------------------------------------------------
  183.  
  184.       Here is the quick version of the setup instructions:
  185.  
  186.       1. Unzip this archive into one subdirectory.
  187.       2. Edit the included SFROM.MAS master configuration file.
  188.       3. Create a separate directory for each CD-ROM disk.
  189.       4. Copy SFROM.CFG to each directory. Edit each SFROM.CFG.
  190.       5. Copy the file lists to each directory. Edit lists if required.
  191.       6. Copy DISK.CLR and DISK.BBS to each directory. Edit as required.
  192.       7. Run the program in local mode: SFROM LOCAL
  193.          Run the program online: SFROM  C:\SF\SFFILE.DAT  C:\CDROM\SFROM.MAS
  194.  
  195.       Take a quick look at SFROM.MAS, SFROM.CFG, DISK.BBS, and you will get
  196.       the general idea. Try executing the command SFROM LOCAL to get a
  197.       quick look at the general appearance of the door.
  198.  
  199.       Here is a more detailed description of each step:
  200.  
  201.       1. Unzip this archive into one subdirectory. This will be the SF-ROM
  202.          home directory, which is named C:\CDROM in the following example,
  203.          but any subdirectory name may be used. You only need one copy of
  204.          SFROM.EXE and it must be kept here.
  205.  
  206.       2. Modify the included SFROM.MAS file to meet your needs.
  207.          See CONFIGURATION COMMANDS below for description of each option.
  208.          This is the master file that sets the configuration and location
  209.          for all of the disks. It "points" to all of the separate SFROM.CFG
  210.          files used by each disk. Any line in SFROM.MAS that does not begin
  211.          with a letter is ignored. The lines that begin with semicolons,
  212.          for example, are used for comments and ignored by the program.
  213.          Keep this file in the SF-ROM home directory.
  214.  
  215.       3. Create a separate subdirectory for each of your CD-ROM disks.
  216.          The general arrangement should look something like this:
  217.                             ┌───────────┐
  218.                             │ SFROM.EXE │ SF-ROM home directory
  219.                             │ SFROM.MAS │
  220.                             └─────┬─────┘
  221.                                   │
  222.                 ┌─────────────────┼─────────────────┬────── - - - etc.
  223.          ┌──────┴───────┐  ┌──────┴───────┐  ┌──────┴───────┐
  224.          │ SFROM.CFG    │  │ SFROM.CFG    │  │ SFROM.CFG    │
  225.          │ DISK.BBS/CLR │  │ DISK.BBS/CLR │  │ DISK.BBS/CLR │
  226.          │ FILE LISTS   │  │ FILE LISTS   │  │ FILE LISTS   │
  227.          └──────────────┘  └──────────────┘  └──────────────┘
  228.           subdirectory      subdirectory       subdirectory
  229.           for disk 1        for disk 2         for disk 3
  230.  
  231.       4. Copy SFROM.CFG to each of the disk subdirectories. This is the
  232.          configuration file for that disk and must be modified to suit that
  233.          disk. SFROM.CFG must contain the disk name and all the paths to
  234.          the files and lists for that disk. This is all that MUST be
  235.          included, any of the other commands are optional, but they will be
  236.          applied if they are there.
  237.  
  238.          SFROM.CFG should also contain the TagChar command for that disk.
  239.          The TagChar command determines which lines of a file list are
  240.          assigned a tag letter and colorized when the list is displayed in
  241.          the door. You can assign any TagChar you like, but it should
  242.          be a character that repeats in the same location on every line
  243.          that contains a file. The default TagChar is a dash at position
  244.          26 which is the first dash in the file date in many lists. You
  245.          can also set TagChar ALL which will assign a tag letter to every
  246.          line in the file list.
  247.  
  248.       5. Prepare an ASCII text file list for each subdirectory on each
  249.          CD-ROM disk. These are often included on the CD-ROM and can
  250.          usually be used with little or no modification. Keep the lists in
  251.          the subdirectory for that disk or on the CD-ROM. The first line of
  252.          each file entry in the list should be in the following format:
  253.  
  254. ....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
  255. SFROM22.ZIP   220,000  01-14-96  SF-ROM v2.20, CD-ROM Door by Mike Robinson
  256. <---Name---><--Size--><-Date----><-------------Description------------------->
  257.  
  258.          This is the standard default single line format. The location and
  259.          display color of each field can be changed by using the FileName,
  260.          FileSize, FileDate, and FileDesc commands as described below in
  261.          the Configuration Commands section.
  262.  
  263.          If Spitfire style multi-line descriptions with "smiley face" 
  264.          (ASCII 02) character are used, the line may be up to 255
  265.          characters long and all on one line. The "smiley face" marks the
  266.          separation between lines. Spitfire multi-line format will be
  267.          automatically recognized by SF-ROM if there is at least one
  268.          "smiley face" on the line. Spitfire v3.5 extended file
  269.          descriptions with a smiley face in column 1 are also recognized.
  270.  
  271.          For other multi-line formats, (such as Night Owl) the description
  272.          lines may lie on multiple lines between column 34 and 78 as shown:
  273.  
  274. ....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
  275. <---Name---><--Size--><-Date----><-------------Description------------------->
  276. SFROM22.ZIP   220,000  01-14-96  SF-ROM v2.20, CD-ROM Door by Mike Robinson
  277.                                | UART, FOSSIL, DIGIBOARD. Now includes
  278.                                | Internal Protocols. Keeps Own Database,
  279.                                | Enforces Limits, MultiDisk, MultiNode
  280.                                | File Tagging, Text Search, Offline
  281.                                | Requests, ZIP & Text Viewer.
  282.                                  <-------------Description------------------->
  283.  
  284.          The character "|" is not required, although it is often included
  285.          in Night Owl type lists. SF-ROM can be configured to not show this
  286.          character by using the DelChar configuration command.
  287.  
  288.          Descriptive headers may be used at the top of each file list or at
  289.          any point within the list. Any line which does not contain the tag
  290.          character at the proper location is assumed to be a description
  291.          line and is displayed without modification. See TAGCHAR in
  292.          Configuration Commands section below.
  293.  
  294.       6. Copy DISK.BBS and DISK.CLR to each of the disk subdirectories.
  295.          This is the display menu showing the file areas available on the
  296.          disk and must be modified to suit the disk. Try to keep these to
  297.          under 22 displayed lines or the top may scroll off the screen.
  298.  
  299.       7. Run the program online via a batch file such as SFFILE.BAT.
  300.          The batch file should contain these commands:
  301.  
  302.          CD C:\CDROM
  303.          SFROM  C:\SF\SFFILE.DAT  C:\CDROM\SFROM.MAS
  304.  
  305.          Spitfire creates one of the following files when a door or menu
  306.          extension is executed. Any one of these may be used in place of
  307.          SFFILE.DAT in the above example:
  308.  
  309.          SFFILE.DAT    File menu extension
  310.          SFMAIN.DAT    Main menu extension
  311.          SFMESS.DAT    Message menu extension
  312.          SFSYSOP.DAT   Sysop menu extension
  313.          SFDOORS.DAT   Door menu
  314.  
  315.          SF-ROM runs multi-disk mode if config file extension is .MAS.
  316.          (Single-disk mode is selected by using extension .CFG)
  317.  
  318. ----- MULTI-NODE OPERATION ----------------------------------------------
  319.  
  320.          If the configuration of each node is the same, then you can use
  321.          the same SFROM.MAS for all nodes. To do this, all paths to all
  322.          files and directories must be the same on every node. The node
  323.          number to use is read from SFFILE.DAT. Non-standard port IRQ
  324.          number and IO address are read from the Spitfire SFNODE.DAT file
  325.          so you are not required to enter these in SFROM.MAS. SF-ROM will
  326.          automatically use the same values as the Spitfire node.
  327.  
  328.          If the file paths to all the files and lists are the same for all
  329.          nodes, then they can all share the same SFROM.CFG for each disk.
  330.          Setup on a network will be easier if you put all the file lists on
  331.          one drive and this drive is remapped to the same drive letter on
  332.          all nodes. It is also helpful for all CD-ROM drives to be remapped
  333.          such that each drive is known by the same drive letter on all
  334.          nodes.
  335.  
  336.          For multi-node operation, it is important that you use the HomeDir
  337.          and RequestDir commands and that all nodes share the same HomeDir
  338.          and RequestDir. The database files SFROM.DAT (caller download
  339.          records) and SFROM.REQ (request records) are kept in the HomeDir.
  340.          The requested files are kept in the RequestDir. So if a caller
  341.          places a request on one node, but calls back to download the
  342.          request on another node, SF-ROM will still be able to look up the
  343.          caller records in the HomeDir and retrieve the files from the
  344.          RequestDir. And the caller's download records will be properly
  345.          maintained no matter which node he calls.
  346.  
  347.          If required, you can make separate partial configuration files for
  348.          each node (optional). On node 1, for example, create a file in the
  349.          current directory called NODE1.CFG. You must use this file name
  350.          for node 1. In this file put only the commands for this node that
  351.          are different from the commands in the SFROM.MAS master
  352.          configuration file. Typical use of the NODE?.CFG file would be to
  353.          specify non-standard port parameters using the commands ForceIrq
  354.          and ForceBase. But you can specify any command that you want
  355.          applied to that node only. This should allow you to use the same
  356.          SFROM.MAS for all nodes. For nodes other than 1, change the 1 in
  357.          NODE1.CFG to the node number of the node.
  358.  
  359.          You can also run a different SFROM.MAS for each node (optional).
  360.          You can name the files SFROM1.MAS, SFROM2.MAS, SFROM3.MAS, etc.
  361.          The extension must be .MAS, but any file name may be used. The
  362.          .MAS extension tells SF-ROM to run in multi-disk mode. If you run
  363.          in single-disk mode, then you can use a different SFROM.CFG for
  364.          each node and name then SFROM1.CFG, SFROM2.CFG, SFROM3.CFG, etc.
  365.  
  366.          If you use a different SFROM.MAS for each node, then the batch
  367.          file that runs SF-ROM must specify the SFROM.MAS for that node:
  368.  
  369.          SFROM  C:\SF\SFFILE.DAT  C:\CDROM\SFROM1.MAS
  370.  
  371.          and on node 2 it would be:
  372.  
  373.          SFROM  C:\SF\SFFILE.DAT  C:\CDROM\SFROM2.MAS
  374.  
  375.  
  376. ----- LOCAL MODE --------------------------------------------------------
  377.  
  378.       SF-ROM may be run in local mode if you log onto the BBS locally.
  379.       It may also be run in local mode from the DOS command line:
  380.  
  381.       CD C:\CDROM
  382.       SFROM  LOCAL
  383.  
  384.       Local mode allows you to browse the lists, tag files, and copy the
  385.       files (and descriptions) to the hard drive.
  386.  
  387.  
  388. ----- SETUP for SINGLE-DISK MODE ----------------------------------------
  389.  
  390.       Single disk mode is the same as multi-disk mode described above
  391.       except the SFROM.MAS file is not used. Therefore, all configuration
  392.       commands must be placed in SFROM.CFG. Run the program online in
  393.       single-disk mode via a batch file such as SFFILE.BAT which should
  394.       contain these commands:
  395.  
  396.          CD C:\CDROM
  397.          SFROM  C:\SF\SFFILE.DAT  C:\CDROM\SFROM.CFG
  398.  
  399.       The extension of .CFG (instead of .MAS) tells SF-ROM to run in
  400.       single- disk mode.
  401.  
  402.       When running local mode, if SFROM.MAS is found in the current
  403.       directory, then multi-disk mode is selected. If SFROM.CFG is found,
  404.       then single-disk mode is run.
  405.  
  406.  
  407. ----- CONFIGURATION COMMANDS --------------------------------------------
  408.  
  409.       The DISKS command must be used in SFROM.MAS.
  410.       The AREAS command must be used in SFROM.CFG.
  411.  
  412.       All other configuration commands are optional.
  413.  
  414.       Configuration commands are used in SFROM.MAS and SFROM.CFG. The
  415.       program reads each line of these files, and if the line begins with a
  416.       configuration command, then the configuration is modified as directed
  417.       by the command. If a line begins with anything other than a letter,
  418.       it is ignored. The explanatory comments are on lines beginning with a
  419.       semicolon and are therefore ignored. Each command must be all the way
  420.       up against the left margin of the file with the first command
  421.       character in column 1. The commands are NOT case sensitive, but they
  422.       must be spelled correctly. The commands may be placed in any order
  423.       within the file.
  424.  
  425.       Most of the configuration commands can be set in either (or both)
  426.       the master SFROM.MAS or the disk specific SFROM.CFG. The values in
  427.       SFROM.MAS prevail when the program is at the first menu. The values
  428.       in SFROM.CFG prevail whenever that disk is loaded or read. If no
  429.       value is specified in SFROM.CFG then the value in SFROM.MAS will
  430.       always be used. Some of the commands are only read once when the
  431.       program starts and are so indicated below.
  432.  
  433.  
  434.       The AREAS commands in SFROM.CFG should look something like this:
  435.  
  436.    AREAS
  437.    E:\001A     C:\CDROM\NIGHT18\DIR1
  438.    E:\002A     C:\CDROM\NIGHT18\DIR2
  439.    E:\003A     C:\CDROM\NIGHT18\DIR3
  440.    E:\004A     C:\CDROM\NIGHT18\DIR4
  441.    E:\005A     C:\CDROM\NIGHT18\DIR5
  442.    E:\006A     C:\CDROM\NIGHT18\DIR6
  443.    E:\007A     C:\CDROM\NIGHT18\DIR7
  444.    E:\008A     C:\CDROM\NIGHT18\DIR8
  445.    AREAS
  446.  
  447.       The AREAS configuration command is MANDATORY for all modes.
  448.       It is only used in SFROM.CFG. It is used to signify both the
  449.       beginning and end of a list of file areas. The example above shows
  450.       8 file areas, but you can have as many as 700 file areas per disk.
  451.       There must be one file area per line. The first line is file area
  452.       number 1 and the rest follow in order until you reach the end.
  453.  
  454.       The list MUST BEGIN and END with the keyword "AREAS".
  455.  
  456.       Each line has two entries separated by at least one blank space. The
  457.       first is the path to the file area on the CD-ROM. The second is the
  458.       full path and filename of the associated file list. So the basic
  459.       format of the AREAS section is:
  460.  
  461.       AREAS
  462.       (DIRECTORY 1)   (FILE LIST 1)
  463.       (DIRECTORY 2)   (FILE LIST 2)
  464.       (DIRECTORY 3)   (FILE LIST 3)
  465.       AREAS
  466.  
  467.       Each CD-ROM directory is paired with a matching list of files in that
  468.       directory. The file lists can have any valid DOS file name. The file
  469.       lists can be located on a normal magnetic hard disk or on the CD-ROM
  470.       (if they exist on the CD-ROM). The door will run much faster if you
  471.       locate the file lists on the normal magnetic hard disk. Note that you
  472.       can also use this door to access normal file areas on your hard
  473.       drive. You can mix normal file areas with CD-ROM areas in the same
  474.       door. The file areas do not have to reside on the same drive letter
  475.       or same physical drive. If you have a network, you can access file
  476.       areas on a different machine. You could even put ALL of your BBS file
  477.       areas in one or more of these doors. For example, you could put adult
  478.       files in one door and restrict access to adults only. Or you could
  479.       have special file doors reserved for privileged, contributing or
  480.       subscribing callers.
  481.  
  482.       The example above is a portion of the sample SFROM.CFG supplied in
  483.       this package. It is for the Night Owl 18 CD-ROM disk first published
  484.       in 1995. The file lists are resident on the CD-ROM and can be easily
  485.       copied to a hard drive.
  486.  
  487.  
  488.       The DISKS commands in SFROM.MAS should look something like this:
  489.  
  490.    DISKS
  491.    1   ON   >0   0   C:\CDROM\DISK1\SFROM.CFG  "Night Owl 18"
  492.    2   OFF  >0   0   C:\CDROM\DISK2\SFROM.CFG  "Arsenal Files 3"
  493.    3   OFF  >0   0   C:\CDROM\DISK3\SFROM.CFG  "So Much Shareware 5"
  494.    4   OFF  >0   0   C:\CDROM\DISK4\SFROM.CFG  "Cream of the Crop 10"
  495.    5   OFF  >0   0   C:\CDROM\DISK5\SFROM.CFG  "Pier 7"
  496.    6   OFF  >0   0   C:\CDROM\DISK6\SFROM.CFG  "Simtel MS DOS"
  497.    DISKS
  498.  
  499.       The DISKS configuration command is MANDATORY for multi-disk mode.
  500.       It is only used in SFROM.MAS and is for multi-disk mode only.
  501.       It is used to signify both the beginning and end of a list of disks.
  502.       Each line in the DISKS section "points" to a SFROM.CFG file for a disk.
  503.       The example above shows 6 disks, but you can have as many as 228.
  504.       There must be one disk per line.
  505.  
  506.       The list MUST BEGIN and END with the keyword "DISKS".
  507.  
  508.       COLUMN 1 is the string of characters that the caller types to select
  509.          the disk. Any string of up to 30 typeable characters may be used.
  510.          No blanks or untypeable characters. Must be one continuous string.
  511.          Do not use the single characters C, E, Q, R, S, or U since these
  512.          are used to select options on the main menu. But you may use words
  513.          of 2 or more characters that begin with these letters. The
  514.          simplest method may be to use a number to indicate each disk as
  515.          done in the example above. If you set AutoMenu ON, then the disks
  516.          will automatically be assigned selection numbers based on their
  517.          order and whatever is placed in this column will be ignored.
  518.       COLUMN 2 shows the disk or door status.
  519.          ON   means online. Downloads allowed. No requests.
  520.          OFF  means offline. Browse only. No downloads or requests allowed.
  521.          REQ  means requests allowed. No downloads. Registered version only.
  522.          CLO  means closed. Noone can enter this disk.
  523.          AUTO-REQ  means online if disk in drive, otherwise set to REQ
  524.          AUTO-OFF  means online if disk in drive, otherwise set to OFF
  525.          AUTO-CLO  means online if disk in drive, otherwise set to CLO
  526.          If you use any AUTO command for a disk, then you MUST use the
  527.          Volume command in the SFROM.CFG for that disk. See below.
  528.       COLUMN 3 shows the security level required to enter the disk.
  529.         For example if it is set to:
  530.         >5   (only security levels greater than 5 may enter)
  531.         <20  (only security levels less than 20 may enter)
  532.         =30  (only security level equal to 30 may enter)
  533.         There must be no spaces between the symbol and the level
  534.         number.
  535.       COLUMN 4 is the type. Set this to 0 for a CD-ROM disk. Set it any
  536.         value between 10 and 255 and SF-ROM will terminate with this
  537.         ErrorLevel when this door is selected by the caller. This allows
  538.         SF-ROM to be used like an external menu program. In this case, you
  539.         need to catch and respond to these ErrorLevels in the batch file
  540.         that runs SF-ROM. CD-ROM disks and external doors may be combined
  541.         freely in the same menu. A normal SF-ROM exit where no door or disk
  542.         is selected is ErrorLevel 0. Internal errors in SF-ROM exit with
  543.         ErrorLevel 1. Do not set ErrorLevels 1 to 9 as these are reserved
  544.         for future use.
  545.       COLUMN 5 is the full path and file name of the SFROM.CFG used
  546.         for each CD-ROM disk. Create a separate subdirectory for each
  547.         disk. Place all the files for that particular disk in the same
  548.         subdirectory along with the SFROM.CFG for that disk. Column 5
  549.         is blank if this line indicates an external door.
  550.       COLUMN 6 is the disk name. Optional. Must be between double quotes
  551.         as shown. If this column is not used, then the disk name will
  552.         be read from SFROM.CFG. Column 6 is blank if this line
  553.         indicates an external door.
  554.  
  555.  
  556.       Explanation of Disk Detection and the AUTO commands:
  557.  
  558.       Optional. Use of any of the AUTO commands for a disk activates the
  559.       disk detect for that particular disk. SF-ROM will read the volume
  560.       name of the disk in the drive and set the disk online if the volume
  561.       name matches the disk volume name in SFROM.CFG. If there is no match,
  562.       then the disk will be set to the fallback status of Request, Offline,
  563.       or Closed. The comparison is not case sensitive, but it must be an
  564.       exact match.
  565.  
  566.       The use of this feature is NOT recommended if you run a multi-disk
  567.       changer such as a Pioneer DRM-60X because it will cause each disk to
  568.       swap in and out every time SF-ROM starts. Disk detect is off by
  569.       default.
  570.  
  571.       To enable Disk Sensing for a disk, you must do TWO things. You must
  572.       use an AUTO command for that disk in the DISKS section of SFROM.MAS,
  573.       and you must place a Volume command in the SFROM.CFG for that disk.
  574.       If a disk is set AUTO, but the volume command does not appear in the
  575.       SFROM.CFG, then the disk volume name will not be read and the disk
  576.       will be set to the fallback status. The auto detect status of each
  577.       disk is independent.
  578.  
  579.       Disk detection is independent of AutoMenu. You can use either, both,
  580.       or neither. If you do use disk detection, then AutoMenu is highly
  581.       recommended so that the menu will always match.
  582.  
  583.       The full list of status commands is:
  584.  
  585.       ON              ( always online )
  586.       REQ             ( always requestable )
  587.       OFF             ( always offline )
  588.       CLO             ( always closed )
  589.       AUTO-REQ        ( online if volume name match, otherwise requestable )
  590.       AUTO-OFF        ( online if volume name match, otherwise offline )
  591.       AUTO-CLOSED     ( online if volume name match, otherwise closed  )
  592.  
  593.       If you have specified a BusyFlag for that disk, then SF-ROM will look
  594.       for the BusyFlag before trying to access the disk. If the BusyFlag is
  595.       found, SF-ROM will wait until the flag is erased by the other node.
  596.       And it will create a new BusyFlag for the time it takes to read the
  597.       volume name. The related commands of FlagDelay and DelOldFlag are
  598.       also read and used if you use a BusyFlag.
  599.  
  600.  
  601.    AUTOMENU  ON
  602.    AUTOMENU  OFF
  603.  
  604.       Optional. Choose one. For multi-disk mode only. AutoMenu is OFF by
  605.       default. When AutoMenu is ON then SF-ROM will automatically construct
  606.       the main disk selection menu of all disks on-the-fly. This menu will
  607.       indicate which disks are online, request, or offline. If you set
  608.       AutoMenu OFF, then SF-ROM will display the menu files MAIN.CLR or
  609.       MAIN.BBS. If neither of these files are not found, then SF-ROM will
  610.       automatically switch back to AUTOMENU ON. See the
  611.       AuotMenuTitle/AutoMenuColor commands below for information on
  612.       customizing the AutoMenu display text and colors.
  613.  
  614.  
  615.    VOLUME  NOPV11_194
  616.  
  617.       Optional. For use in SFROM.CFG only. Defines the volume name of the
  618.       disk used for purposes of disk detection. This command is only
  619.       required on those disks defined as AUTO in the DISKS section of
  620.       SFROM.MAS. The volume name for Night Owl 11 is shown. Use the correct
  621.       volume name for your disk. You can get the volume name by using the
  622.       DOS VOL command. DOS limits the volume name to 11 characters. Before
  623.       making the comparison, SF-ROM automatically strips any spaces and
  624.       periods from both the volume name specified and the volume name read
  625.       from the disk.
  626.  
  627.       Disk scanning is NOT recommended on multi-disk changers because it
  628.       will cause each disk to swap in and out every time SF-ROM starts.
  629.  
  630.       The simple form of the Volume command is shown above, but there are
  631.       additional options. If you have more than one CD-ROM drive, then you
  632.       may want to use the /SCAN option:
  633.  
  634.       VOLUME  NOPV11_194  /SCAN  EF
  635.  
  636.       This means SF-ROM will look for the volume name NOPV11_194 on both
  637.       drives E and F. You can scan up to 26 drive letters from A to Z. The
  638.       drives are always scanned in order from A to Z. It will stop scanning
  639.       drives when it reaches the first matching volume name. Once a drive
  640.       letter has been assigned to a disk, that drive letter will not be
  641.       scanned again. If you do not use the /SCAN command, then it will only
  642.       scan the drive letter indicated in the first entry in the left column
  643.       in the AREAS section of SFROM.CFG. The drive letter specified in the
  644.       AREAS section will also be scanned in addition to any drives
  645.       specified using the /SCAN command. If you use the optional CDDRIVE
  646.       command, this drive letter will also be scanned. If the same drive
  647.       letter is specified more than once, it will only be scanned once.
  648.  
  649.       If the CD-ROM disk does not have a volume label, you may want to
  650.       use the option to scan for a specific marker file like this:
  651.  
  652.       VOLUME  E:\GAMES\DOOM2.ZIP
  653.  
  654.       The backslash character "\" must be used. It indicates that SF-ROM is
  655.       to scan for a specific file and NOT scan for a volume label. If no
  656.       backslash character is used, SF-ROM will assume that it is a volume
  657.       label. Choose a path and file name unique to that particular disk.
  658.  
  659.       Here is another form of this command:
  660.  
  661.       VOLUME  E:\GAMES\DOOM2.ZIP  /SCAN  EF
  662.  
  663.       In this case, SF-ROM will look for file E:\GAMES\DOOM2.ZIP and if it
  664.       is not there, it will then look for file F:\GAMES\DOOM2.ZIP. The
  665.       scanning operation is exactly the same except that a specific file
  666.       name is used instead of a volume label. All of the previously defined
  667.       scanning rules apply.
  668.  
  669.       The backslash "\" indicates a specific file name.
  670.       The forward slash "/SCAN" indicates multiple disk scanning.
  671.       Please do not confuse forward slash and backslash.
  672.  
  673.       If you have problems with disk scanning, see command DebugVol.
  674.       Setting this command ON will cause SF-ROM to log all scanning
  675.       operations and results to file ERROR.LOG.
  676.  
  677.  
  678.    HOLDDIR  C:\CDROM\HOLD
  679.  
  680.       Mandatory. This is the holding directory where the files are copied
  681.       to if CopyToMag is ON. The program also writes the batch download
  682.       file list here in all cases. This list is named EXT1.LST where the 1
  683.       indicates the node number. The program takes care of its own
  684.       housekeeping and deletes the copied files after the download. Just
  685.       the copied files are deleted. Any other files that exist in this
  686.       directory will NOT be deleted. In local mode, the files are also
  687.       copied here and the descriptions are added to a FILES.BBS in this
  688.       subdirectory. If no FILES.BBS exists, one is created. Default is the
  689.       directory specified by HomeDir. If no HoldDir is specified and no
  690.       HomeDir is specified, then the default is the current directory.
  691.  
  692.  
  693.    HOMEDIR  C:\CDROM
  694.  
  695.       Optional. This is the SF-ROM home directory. In registered versions,
  696.       this is where the request data file SFROM.REQ and the caller database
  697.       SFROM.DAT is created and kept. On multi-node systems, these files can
  698.       (and should) be shared by all nodes if the same HomeDir is specified
  699.       for all nodes. Default is the current directory.
  700.  
  701.  
  702.    REQUESTDIR  C:\CDROM\REQUEST
  703.  
  704.       Registered versions only.
  705.       Mandatory if file requests from offline disks are allowed.
  706.       This is the holding directory where the requested files are held
  707.       after they are copied to the hard drive. The program takes care of
  708.       its own housekeeping and deletes the requested files after the caller
  709.       successfully downloads the files AND exits the door. So if the caller
  710.       fails the download, but SF-ROM thinks the download was a success, the
  711.       files will remain in place until the caller exits SF-ROM. If SF-ROM
  712.       thinks the download failed, the files will not be deleted. Just the
  713.       downloaded files are deleted. Any other files that exist in this
  714.       directory will NOT be deleted. If more than one caller has requested
  715.       the same file, the file will not be deleted until all callers have
  716.       downloaded the file.
  717.       Default is the directory specified by HoldDir. If no RequestDir is
  718.       specified and no HoldDir is specified, then the default is the
  719.       current directory.
  720.  
  721.    PROTOCOL EXTERNAL
  722.  
  723.       Optional. Registered version only.
  724.       This command turns off the internal protocols and causes the program
  725.       to use external X/Y/Zmodem protocols supplied by the shareware DSZ
  726.       program by Chuck Forsberg of Omen Tech. A copy of DSZ.COM or DSZ.EXE
  727.       must be in the current directory or on your DOS path. I recommend
  728.       the use of the internal protocols which is the default, or you can
  729.       set them explicitly with the command PROTOCOL INTERNAL.
  730.  
  731.  
  732.    DRIVER  UART
  733.    DRIVER  FOSSIL
  734.    DRIVER  DIGIBOARD
  735.  
  736.       Optional. Choose ONE. Default is Driver UART.
  737.       SF-ROM can use one of 3 different communications drivers:
  738.  
  739.       UART ........ Use the built-in SF-ROM UART comm driver. This is the
  740.                     standard driver that was used in all previous versions
  741.                     of SF-ROM. Most people will use this driver.
  742.                     Port speeds up to 115,200 bps are supported.
  743.  
  744.       FOSSIL ...... Use external Fossil driver. Maximum speed 38400 bps.
  745.                     SF-ROM has been tested with BNU 1.70 and X00 1.53.
  746.                     The Fossil must be properly configured and loaded in
  747.                     memory. I do not recommend the use of this command if
  748.                     you run your Fossil faster than 38400. If you run your
  749.                     port at 57600 or 115200 then you should use Driver UART
  750.                     if possible.
  751.  
  752.       DIGIBOARD ... Use external DigiBoard comm driver such as XIDOS5.SYS.
  753.                     SF-ROM works with any of the following DigiBoards:
  754.                     COM/Xi, PC/Xi, PC/Xe. The DigiBoard XIDOS5.SYS device
  755.                     driver or equivalent must be properly configured and
  756.                     loaded in memory. The DigiBoard channel used is the Com
  757.                     number minus 1. So for Com2, SF-ROM will use channel 1.
  758.                     For Com1, it will use channel 0.
  759.                     Port speeds up to 115,200 bps are supported.
  760.  
  761.  
  762.    DISKNAME  Night Owl 18
  763.  
  764.       Optional. This command is only used in SFROM.CFG and has no effect in
  765.       SFROM.MAS. This name is used in the local status bar display on the
  766.       top of the screen and in the door log entries.
  767.       Default is no name.
  768.  
  769.  
  770.    COPYTOMAG ON
  771.    COPYTOMAG OFF
  772.  
  773.       Optional. Choose one. If CopyToMag ON then files will be copied to
  774.       the magnetic hard drive just before downloading. These files will
  775.       then be erased once the download is completed. If CopyToMag OFF then
  776.       the files will be downloaded directly from the CD-ROM drive.
  777.       CopyToMag ON is recommended for multi-disk changers.
  778.       Default is CopyToMag ON.
  779.  
  780.  
  781.    FILEVIEW ON
  782.    FILEVIEW OFF
  783.  
  784.       Optional. Choose one.
  785.       Turns the file viewer ON or OFF.
  786.       Some multi-node systems may want to turn FileView OFF since the
  787.       CD-ROM drive must be read to view a file and this can create a lot of
  788.       traffic. If the BusyFlag option is used (see below), then a busy flag
  789.       is created when a file is viewed and all of the other BusyFlag
  790.       control parameters apply. The busy flag is erased as soon as the
  791.       caller returns from viewing the file. Note that this can tie up the
  792.       drive for the entire time a caller is viewing the file. If busy flags
  793.       are not used, then multiple nodes can simultaneously access the drive
  794.       for both viewing and download purposes. If FileView is OFF, then the
  795.       View option does not appear on the caller menu prompts.
  796.  
  797.       The file viewer will show the internal contents of a ZIP file if
  798.       the file has an extension of .ZIP. Otherwise, the viewer looks at the
  799.       file and if it seems to be a text file (no unprintable characters)
  800.       then the viewer display the text file. The viewer cannot display text
  801.       files within ZIP files. If the viewer gets fooled and a .ZIP
  802.       is not really a ZIP, or a text file is not really a text file, then
  803.       the caller may see a bunch of harmless garbage characters.
  804.       Default is FileView ON.
  805.  
  806.  
  807.    SHARE ON
  808.    SHARE OFF
  809.  
  810.       Optional. Choose one. Turns file sharing and locking ON or OFF.
  811.       If you have more than 1 node, or you want to fill requests while a
  812.       caller is online, then set Share ON. In order for file sharing and
  813.       locking to work, you must use DOS 3.1 or higher, and DOS SHARE.EXE
  814.       must be loaded in your CONFIG.SYS or AUTOEXEC.BAT. If file sharing is
  815.       not required, then set Share OFF. This program will run noticeably
  816.       faster with Share OFF.
  817.       Default is Share OFF.
  818.  
  819.  
  820.    TIMEOUT 180
  821.  
  822.       Optional. This is the caller inactivity timeout delay in SECONDS.
  823.       If no keystrokes are received for this length of time, the door will
  824.       exit and return the caller to the BBS. Timeout only applies when the
  825.       door is run from the BBS. There will be no timeout when run from the
  826.       DOS command line.
  827.       Values from 60 to 600 seconds are allowed.
  828.       Default is 180 seconds (3 minutes).
  829.  
  830.  
  831.    DELAYSECS 10
  832.  
  833.       Optional. This the pause time in seconds for the "Strike any Key To
  834.       Continue" message that appears in many places in the door. The door
  835.       will wait for a keystroke for this number of seconds. If no keystroke
  836.       is received within this time, then the door will proceed to the next
  837.       screen. If some of the display screens pass by too quickly to read,
  838.       then try increasing this number.
  839.       Values from 1 to 3600 seconds are allowed.
  840.       Default is 10 seconds.
  841.  
  842.  
  843.    DEBUG ON
  844.    DEBUG OFF
  845.  
  846.       Optional. Choose one. Most program error conditions are logged to
  847.       ERROR.LOG if Debug is turned on. The program may load a bit faster if
  848.       you turn this off. If you have problems, leave Debug ON.
  849.       Default is Debug ON.
  850.  
  851.  
  852.    DEBUGVOL ON
  853.    DEBUGVOL OFF
  854.  
  855.       Optional. Choose one. Setting this command ON will cause SF-ROM to
  856.       log all volume label scanning operations and results to file
  857.       ERROR.LOG. If you have disk scanning problems, set this command ON.
  858.       Default is DebugVol OFF.
  859.  
  860.  
  861.    DROPPENALTY 300
  862.  
  863.       Optional. Number of SECONDS to penalize the caller if carrier is
  864.       dropped when in the door. This time will be subtracted from the
  865.       callers time allowed during the next call that day. If the caller
  866.       does not call back until the next day, then this penalty will have no
  867.       effect.
  868.       Values from 0 to 7200 seconds (0 to 120 minutes) are allowed.
  869.       Default is 300 seconds (5 minutes).
  870.  
  871.  
  872.    ALLOWLOGOFF ON
  873.    ALLOWLOGOFF OFF
  874.  
  875.       Optional. If AllowLogOff ON then the caller will be offered the
  876.       option to select unattended automatic logoff after each download.
  877.       Default is AllowLogOff ON.
  878.  
  879.  
  880.    LINESPERPAGE 21
  881.  
  882.       Optional. Determines the number of lines shown for each screen page
  883.       when the caller is scrolling through the file lists, viewing a menu
  884.       screen, or viewing a file. A typical IBM PC clone screen has 25
  885.       lines. But since 2 lines are used at the top for the information bar,
  886.       and 2 lines are used at the bottom for the command prompts, only 21
  887.       lines remain for use by the rest of the display.
  888.       Values from 5 to 22 lines per page are allowed.
  889.       Default is 21 lines per page.
  890.  
  891.  
  892.    LINESPERFILE 5
  893.  
  894.       Optional. Determines the maximum number of lines shown for each file
  895.       when the caller is scrolling through the file lists, or doing a text
  896.       search. Only applies to files with a multi-line description. Values
  897.       from 1 to (the number of lines per page - 2) are allowed.
  898.       Default is 5 lines per file.
  899.       You can use this command in SFROM.MAS and/or SFROM.CFG. I recommend
  900.       that you set it once in SFROM.MAS as an initial value, and then let
  901.       the caller make any desired changes in the utility menu. If you set a
  902.       value in SFROM.CFG then it will force it to this value every time the
  903.       caller enters that disk.
  904.  
  905.  
  906.    TAGCHAR  26  -
  907.  
  908.       Optional. This determines the line position and character used to
  909.       determine which lines in a file list contain a valid file for tagging
  910.       and display purposes.
  911.  
  912.       If you want a tag character to appear on every line in the file list
  913.       then use this command:
  914.  
  915.       TagChar ALL
  916.  
  917.       This is a good choice for lists which do not contain a feasible tag
  918.       character, such as those lists with only a file name and description.
  919.       Do not use this option for lists that have headers or contain any
  920.       lines which are not files.
  921.  
  922.       If you set a specific tag character, then lines which
  923.       contain this exact character at this exact position are colorized and
  924.       assigned a tag letter. Lines which do NOT contain this character at
  925.       this position are assumed to be header lines or extended description
  926.       lines. Default is a dash at position 26 as shown below:
  927.  
  928. ....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
  929. SFROM22.ZIP   220,000  01-14-96  SF-ROM v2.20, CD-ROM Door by Mike Robinson
  930.                          ^
  931.                          character at position (column) 26 is a dash
  932.  
  933.       Examples of common file formats:
  934.       TagChar 26 -   (tag lines with a dash at position 26) (DEFAULT)
  935.                      (Typically used in Spitfire & Night Owl type lists)
  936.  
  937.       TagChar 28 -   (tag lines with a dash at position 28)
  938.       TagChar 26 /   (tag lines with a forward slash at position 26)
  939.       TagChar 28 /   (tag lines with a forward slash at position 28)
  940.       TagChar 18 ,   (tag lines with a comma at position 18 )
  941.  
  942.       Only one character and position may be designated as the TagChar. If
  943.       multiple TagChar are specified in SFROM.CFG then the last TagChar
  944.       specified is used. For file tagging to work properly, the file name
  945.       must be listed first on each line of the file list (column position
  946.       1 to 12). SF-ROM is smart enough to recognize the file name even if
  947.       it is "fractured" and not continuous like in these examples:
  948. ....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
  949. FILE1   .ZIP  344,101  01-31-94  A good game
  950. FILE1.   ZIP  344,101  01-31-94  A good game
  951. FILE1    ZIP  344,101  01-31-94  A good game
  952.       The last example is typical of file lists that are created based on
  953.       the DOS DIR command.
  954.  
  955.  
  956.    DELCHAR 32 |
  957.  
  958.       This sets a line position and a single character that will stripped out
  959.       from every line of a file list. "Night Owl" or "PCBoard" style
  960.       multi-line file lists often have a | character at position 32. Use of
  961.       this command causes the specified character to be replaced by a blank
  962.       in the file list display. The file list itself is not modified. In the
  963.       example shown, on all lines where character | is found in position 32,
  964.       it will be replaced by a blank space.
  965.  
  966.       Only one character and position may be designated as the DelChar. If
  967.       multiple DelChar are specified then only the last DelChar specified is
  968.       used. Any character and any position from 1 to 78 may be used. The
  969.       position is determined by the actual position on the line in the file
  970.       before any display modifications are made by the FileName, FileSize,
  971.       FileDate, FileDesc commands.
  972.  
  973.       The default is a | at position 32 as shown below:
  974. ....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
  975. SFROM22.ZIP   220,000  01-14-96  SF-ROM v2.20, CD-ROM Door by Mike Robinson
  976.                                |  UART, FOSSIL, DIGIBOARD. Now includes
  977.                                |  Internal Protocols. Keeps Own Database,
  978.                                |  Enforces Limits, MultiDisk, MultiNode
  979.                                |  File Tagging, Text Search, Offline
  980.                                |  Requests, ZIP & Text Viewer.
  981.                                ^
  982.                                character at position (column) 32 is a |
  983.  
  984.  
  985.    MULTICHAR  02
  986.  
  987.       Optional. Applies only to Spitfire style multi-line formats where the
  988.       character that marks the beginning of each new line is usually a
  989.       "smiley face"  (ASCII 02) character. This command allows you to
  990.       specify the use of a different line marker character instead of the
  991.       default ASCII 02. If a number from 1 to 255 is specified, then the
  992.       ASCII equivalent character will be used. If a non-numerical character
  993.       is specified, then this exact character will be used.
  994.  
  995.  
  996.    STATLINE  TOP  1  14
  997.  
  998.       Optional. Default values are shown.
  999.       TOP means the status line will appear on the top of the screen.
  1000.       The 1 is the background color code (blue). The 14 is the foreground
  1001.       color code (yellow). You can use the command BOTTOM in place of TOP
  1002.       and the line will appear on the bottom of the screen.
  1003.  
  1004.       Background colors from 0 to  7 are allowed.
  1005.       Foreground colors from 0 to 15 are allowed.
  1006.       The color codes are:
  1007.  
  1008.       Black.......... 0       DarkGray....... 8
  1009.       Blue........... 1       LightBlue...... 9
  1010.       Green.......... 2       LightGreen.... 10
  1011.       Cyan........... 3       LightCyan..... 11
  1012.       Red............ 4       LightRed...... 12
  1013.       Magenta........ 5       LightMagenta.. 13
  1014.       Brown.......... 6       Yellow........ 14
  1015.       LightGray...... 7       White......... 15
  1016.  
  1017.  
  1018.  
  1019.    FILENAME    1    12    15
  1020.    FILESIZE   13    10    14
  1021.    FILEDATE   23    11    10
  1022.    FILEDESC   34    45    11
  1023.  
  1024.       Optional. Default values are shown.
  1025.       These 4 configuration commands control how the file lists are
  1026.       displayed. For example:
  1027.  
  1028.       FILENAME    1    12    15
  1029.       This means that the file name starts at line column position 1
  1030.       and is 12 characters long. The 15 is the display color code.
  1031.       The default values are shown above and in this sample line:
  1032. ....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
  1033. SFROM22.ZIP   220,000  01-14-96  SF-ROM v2.20, CD-ROM Door by Mike Robinson
  1034. <---Name---><--Size--><-Date----><-------------Description------------------->
  1035.  
  1036.       The total number of characters displayed by all 4 zones should not
  1037.       exceed 78 or the line display may wrap onto the next line.
  1038.  
  1039.       Colors codes from 9 to 15 are allowed.
  1040.       The color codes are:
  1041.  
  1042.       LightBlue...... 9
  1043.       LightGreen.... 10
  1044.       LightCyan..... 11
  1045.       LightRed...... 12
  1046.       LightMagenta.. 13
  1047.       Yellow........ 14
  1048.       White......... 15
  1049.  
  1050.  
  1051.    HEADLINE    1    78    11
  1052.  
  1053.       Optional. Default values are shown.
  1054.       This command works just like the four above, except it applies to the
  1055.       optional header section at the top of a file list. It means that 78
  1056.       characters will be displayed, starting at character number 1 and the
  1057.       display color will be 11 (Light Cyan).
  1058.       Colors codes from 9 to 15 are allowed.
  1059.  
  1060.  
  1061.    AUTOMENUCOLOR  TOP      12  15
  1062.    AUTOMENUCOLOR  ONLINE   15  14  11  15
  1063.    AUTOMENUCOLOR  REQUEST   7  14   3   7
  1064.    AUTOMENUCOLOR  OFFLINE   7  14   7   7
  1065.  
  1066.       Optional. Default values are shown.
  1067.       These 4 configuration commands control the colors used in the
  1068.       AutoMenu disk selection display screen.
  1069.       AutoMenuColor TOP defines the colors of the title line at the top of
  1070.       the menu. AutoMenuColor ONLINE defines the colors of disks that are
  1071.       online. AutoMenuColor REQUEST defines the colors of disks that are
  1072.       requestable. And so on. The colors are in order as they appear
  1073.       onscreen. So if you use this command
  1074.  
  1075.       AutoMenuColor  ONLINE   15  14  11  15
  1076.  
  1077.       then an online disk will be displayed like this:
  1078.  
  1079.       < 1> ONLINE- Night Owl 18
  1080.  
  1081.       The brackets will be color 15.
  1082.       The 1 will be color 14
  1083.       The ONLINE- will be color 11
  1084.       The Night Owl 18 will be color 15.
  1085.  
  1086.       AutoMenuColor TOP has only 2 colors. The first is the color of the
  1087.       leading/trailing asterisk. The second is the color of the text.
  1088.  
  1089.       The color codes are the same as used in the list displays:
  1090.       Black.......... 0       DarkGray....... 8
  1091.       Blue........... 1       LightBlue...... 9
  1092.       Green.......... 2       LightGreen.... 10
  1093.       Cyan........... 3       LightCyan..... 11
  1094.       Red............ 4       LightRed...... 12
  1095.       Magenta........ 5       LightMagenta.. 13
  1096.       Brown.......... 6       Yellow........ 14
  1097.       LightGray...... 7       White......... 15
  1098.  
  1099.  
  1100.     AUTOMENUTITLE  The title at top of AutoMenu goes here
  1101.  
  1102.       Optional. Registered versions only. Defines the text at the top of
  1103.       the AutoMenu screen. In unregistered versions, the default top line
  1104.       cannot be changed and looks like this:
  1105.  
  1106.       * SF-ROM - The Spitfire CD-ROM Door *
  1107.  
  1108.       In the registered version, the default top line looks like this:
  1109.  
  1110.       * "Your BBS Name" - Files On CD-ROM *
  1111.  
  1112.       It replaces the "Your BBS Name" with your actual BBS name which
  1113.       it reads from the registration key file.
  1114.  
  1115.       Use the optional AutoMenuTitle command to define your own title.
  1116.       SF-ROM automatically puts an asterisk before and after the text you
  1117.       specify with this command.
  1118.  
  1119.  
  1120.    NODOWNLOAD 10 15 20
  1121.  
  1122.       Optional. This sets no download status for listed security levels.
  1123.       You may also use the word ALL in place of the listed levels and then
  1124.       all security levels will not be allowed to download. In the example
  1125.       shown above security levels 10, 15 and 20 are not allowed to
  1126.       download. Up to 20 levels can be set on one NoDownLoad line. Use as
  1127.       many lines as your require, each line beginning with NoDownLoad. If
  1128.       this command is set in SFROM.MAS, then it applies to all disks. If
  1129.       set in SFROM.CFG then it applies to just one disk. The value in
  1130.       SFROM.CFG prevails. Default is downloads allowed.
  1131.  
  1132.  
  1133.    NOREQUEST 10 15 20
  1134.  
  1135.       Optional. Registered versions only.
  1136.       This sets no request status for listed security levels.
  1137.       You may also use the word ALL in place of the listed levels and then
  1138.       all security levels will not be allowed to request files. In the
  1139.       example shown above security levels 10, 15 and 20 are not allowed to
  1140.       request files. Up to 20 levels can be set on one NoRequest line. Use
  1141.       as many lines as your require, each line beginning with NoRequest. If
  1142.       running multi-disk and this command is set in SFROM.MAS, then it
  1143.       applies to all disks. If set in SFROM.CFG then it applies to just one
  1144.       disk. The value in SFROM.CFG prevails. Default is requests allowed.
  1145.  
  1146.  
  1147.    CHECKSIZE ON
  1148.    CHECKSIZE OFF
  1149.  
  1150.       Optional. Choose one. If ON, then the CD-ROM drive will be read
  1151.       during file tagging to determine if the file is actually there and
  1152.       it's size/date. If OFF, then the CD-ROM will not be read during file
  1153.       tagging, and the file size and date will be read from the file list.
  1154.       This will speed up the tagging operation and reduce the load on the
  1155.       CD-ROM drive on multi-node and networked systems. OFF should work
  1156.       well if your file lists have accurate file sizes and are in a format
  1157.       where the size is listed in columns 9 to 21 (default) or in the
  1158.       position specified by the FileSize command. Note that if the file
  1159.       size in the list is wrong, a caller could exceed his daily byte or
  1160.       time limit. If set OFF and a file size cannot be read from the list,
  1161.       then a default size of 50 kilobytes is used. If this command is used
  1162.       in SFROM.MAS, then it applies to all disks. If used in SFROM.CFG, it
  1163.       applies to just one disk. Default is CheckSize ON.
  1164.  
  1165.  
  1166.    GRAPHICS ON
  1167.    GRAPHICS OFF
  1168.  
  1169.       Optional. SF-ROM will automatically read the graphics mode from
  1170.       SFFILE.DAT (or equivalent) line 10. This command overrides the value
  1171.       passed in SFFILE.DAT.
  1172.       Graphics ON  forces SF-ROM to start in ANSI  graphics (Color) mode.
  1173.       Graphics OFF forces SF-ROM to start in ASCII graphics (B & W) mode.
  1174.  
  1175.  
  1176.    DLTIMER 30
  1177.  
  1178.       Optional. This command only applies to external protocols. It is used
  1179.       in determining whether a download was successful. The default is 30.
  1180.       If a download takes more than 30 percent of the estimated download
  1181.       time, then it is assumed to be successful. Allowable range is from 1
  1182.       to 255. Note that there is no decimal point or percent sign on the
  1183.       command line. Just the number 30 alone means 30 percent. Please
  1184.       consider that setting this too low will result in callers being
  1185.       "charged" for failed downloads. Setting it too high may allow some
  1186.       callers to download without being "charged". Default is 30.
  1187.  
  1188.  
  1189.    LISTDRIVE K
  1190.  
  1191.       Optional. Typically, this will only be used on a network where disk
  1192.       drive letters are reassigned. This command applies to both SFROM.MAS
  1193.       and SFROM.CFG. In SFROM.MAS it changes the drive letter of the path
  1194.       to each SFROM.CFG in the DISKS section. In SFROM.CFG it changes the
  1195.       drive letter of each file list in the AREAS section (right column).
  1196.       It does NOT alter the drive letter of the CD-ROM drive in the AREAS
  1197.       section. No matter what drive letter was actually specified, it is
  1198.       changed to the drive letter following the ListDrive command.
  1199.       Example:
  1200.       I run a 2 node BBS using an Artisoft LANtastic network. Node 1 is
  1201.       drive C. My SFROM.MAS file, all of my SFROM.CFG files, and all of my
  1202.       file lists are on node 1 drive C. In SFROM.MAS all of the paths in
  1203.       the DISKS section begin with the drive letter C. In each SFROM.CFG
  1204.       the path to each file list in the AREAS section begins with the drive
  1205.       letter C. When logged onto node 2, node 1 drive C is remapped to K.
  1206.       So I copied the exact same SFROM.MAS file from node 1 to node 2 and
  1207.       added just one line to it: ListDrive K. So both nodes share the same
  1208.       set of SFROM.CFG files and file lists. But each node has it's own
  1209.       SFROM.MAS file. The only difference between the 2 SFROM.MAS files is
  1210.       that node 2 contains the ListDrive K command. On my BBS, each of my
  1211.       CD-ROM drives uses the same drive letter on all nodes of my network.
  1212.       So CD-ROM drive N is CD-ROM drive N on all nodes. See CDDRIVE command
  1213.       if you need to remap CD-ROM drive letters.
  1214.       If the ListDrive command is used in SFROM.MAS then it will apply to
  1215.       SFROM.MAS and also to ALL of the SFROM.CFG files. If it is used in a
  1216.       SFROM.CFG file then it applies to just that one SFROM.CFG file. In
  1217.       general, I recommend that you only use this command in SFROM.MAS.
  1218.  
  1219.  
  1220.    CDDRIVE F
  1221.  
  1222.       Optional. Typically, this will only be used on a network where disk
  1223.       drive letters are reassigned. This command applies to SFROM.CFG only.
  1224.       It changes the drive letter of each CD-ROM drive directory in the
  1225.       AREAS section (left column). No matter what CD-ROM drive letter was
  1226.       actually specified, it is changed to the drive letter following the
  1227.       CDDrive command.
  1228.       Do NOT use this command in SFROM.MAS since it is would then apply
  1229.       to ALL of your CD-ROM disks and it is very unlikely that they all
  1230.       have the same drive letter.
  1231.  
  1232.  
  1233.    BUSYFLAG C:\CDROM\HOLD\DRIVE1.BSY
  1234.  
  1235.       Optional. This command is NOT required on most systems.
  1236.       It is designed for use with CD-ROM multi-disk changers (such as the
  1237.       Pioneer DRM series) where the same changer is used on 2 or more BBS
  1238.       nodes. If you do not have a multi-disk changer, then you probably
  1239.       do not need this command. If you run a single node BBS, then you
  1240.       probably do not need this command.
  1241.  
  1242.       This command prevents collisions where more than one caller tries to
  1243.       access the CD-ROM drive at the same time. Most single-disk CD-ROM
  1244.       drives are fast enough to handle this without the use of a busyflag.
  1245.  
  1246.       A semaphore marker file system of collision protection is set by this
  1247.       command. SF-ROM checks for the existence of this busy flag file
  1248.       before each CD-ROM read. If the file is there, then it waits until
  1249.       the other node erases the file. SF-ROM creates this file whenever it
  1250.       begins to read from the CD-ROM drive and erases this file when the
  1251.       read is complete. The same busy flag name must be set for each disk
  1252.       that uses the same drive.
  1253.  
  1254.       Default is no busy flag used.
  1255.  
  1256.  
  1257.    FLAGDELAY 30
  1258.  
  1259.       Optional. For use with the BusyFlag command.
  1260.       Sets the maximum time in seconds that the door will wait for a busy
  1261.       CD-ROM drive. In the example above, the door will wait for up to 30
  1262.       seconds before halting the attempted disk read operation and sending
  1263.       a message of "please try again later."
  1264.       Allowable range is 0 to 300 seconds.
  1265.       Default is 30 seconds.
  1266.  
  1267.  
  1268.    DELOLDFLAG 30
  1269.  
  1270.       Optional. For use with the BusyFlag command.
  1271.       When SF-ROM encounters a busyflag, it checks it's age. If it is older
  1272.       than DELOLDFLAG in minutes, then the flag is deleted. Only the flag
  1273.       declared by the BusyFlag command in the same configuration file is
  1274.       deleted. This is a cleanup feature in case old flags are orphaned by
  1275.       a power failure or other system problem. The default is 30 minutes
  1276.       which means the door will delete any flag older than 30 minutes. The
  1277.       system clocks on a network must be synchronized in order for this
  1278.       command to work properly. It is recommended that you set this value
  1279.       to at least the maximum system time difference between any 2 network
  1280.       nodes. Remember that PC system clocks tend to drift out of
  1281.       synchronization over time.
  1282.       The allowable range is 5 to 720 minutes.
  1283.       Default is 30 minutes.
  1284.  
  1285.  
  1286.    XDISK RUNXDISK.BAT
  1287.  
  1288.       Optional. Registered versions only. This batch file is run BEFORE the
  1289.       files are copied to the hard drive. It is intended for use with XDISK
  1290.       program that can be used to swap disks in some Pioneer CD-ROM
  1291.       multi-disk changers. It is likely that this command will only be
  1292.       required if you use more than one Pioneer drive and have run out of
  1293.       DOS drive letters. But you can use it for any purpose you choose. See
  1294.       the BeforeBat command for a batch file that runs after the files are
  1295.       copied to the hard drive. If you use a BusyFlag then it will be
  1296.       created just prior to executing this batch file.
  1297.       The following DOS variable parameters are passed for use by the
  1298.       batch file:
  1299.  
  1300.       %1  The disk number. The first disk in the DISKS section of SFROM.MAS
  1301.           is disk number 1. The remaining disk numbers are assigned in
  1302.           increasing order to the disks following disk 1.
  1303.       %2  The directory on the hard drive where the files are copied to.
  1304.           There is no tailing backslash.  Example:  %1 = C:\CDROM\HOLD
  1305.       %3  The callers connect speed.  Example: %2 = 14400
  1306.       %4  The port number.  Example %3 = 2
  1307.           If you are using a non-standard port where you have changed the
  1308.           IRQ number or IO base address, then %3 will be the base address
  1309.           followed by a comma followed by the IRQ number. This is the same
  1310.           as used by DSZmodem for non-standard ports.
  1311.           Example:  %3 = 3e8,4   if you are using address 3e8 and IRQ 4.
  1312.       %5  The full path and file name of the list of files being
  1313.           downloaded. This is the holding directory followed by EXT1.LST
  1314.           where the 1 represents the node number as passed on line 4 of
  1315.           SFFILE.DAT. If your holding directory is C:\CDROM\HOLD and you are
  1316.           using node 1 then %4 = C:\CDROM\HOLD\EXT1.LST. This same file
  1317.           name is passed to DSZmodem to tell it which files to download
  1318.           when the caller is using Y or Zmodem. If the caller is using
  1319.           Xmodem, then this list is not created.
  1320.  
  1321.       A typical batch file might look like this:
  1322.  
  1323.       XDISK f: %1
  1324.  
  1325.       This runs the XDISK program and assigns the disk number passed in %1
  1326.       to DOS drive letter F. If you use this command in SFROM.MAS then it
  1327.       will apply to all disks. If you use it in SFROM.CFG then it just
  1328.       applies to one disk.
  1329.  
  1330.  
  1331.    DATABASE INTERNAL
  1332.    DATABASE DOORDROPFILE
  1333.    DATABASE COMBINED
  1334.  
  1335.       Optional. Registered versions only. Choose one.
  1336.       Spitfire BBS should use the default of DoorDropFile.
  1337.       The other options are offered should someone want to run SF-ROM on
  1338.       another type of BBS.
  1339.  
  1340.       Registered versions of SF-ROM keep a separate database of files/bytes
  1341.       requested and downloaded in the door in the SFROM.DAT file. This is
  1342.       fully automatic and cannot be changed. This command determines how
  1343.       this information is used to limit the number of files/bytes
  1344.       downloaded per day:
  1345.  
  1346.       INTERNAL ....... Only the data in SFROM.DAT is used. So only the
  1347.                        files downloaded in SF-ROM count against the
  1348.                        caller's limits.
  1349.  
  1350.       DOORDROPFILE ... The number of files/bytes downloaded today is read
  1351.                        from SFFILE.DAT (or equivalent). The number
  1352.                        files/bytes requested today is read from SFROM.DAT
  1353.                        since SFFILE.DAT does not track requests.
  1354.  
  1355.       COMBINED ....... The number of files/bytes downloaded today read from
  1356.                        SFFILE.DAT is added to the number of files/bytes
  1357.                        downloaded today read from SFROM.DAT. The number of
  1358.                        files/bytes requested today is still read from
  1359.                        SFROM.DAT only since SFFILE.DAT does not track
  1360.                        requests. Don't use this option with Spitfire.
  1361.  
  1362.       The default is DATABASE DOORDROPFILE which work very well with
  1363.       Spitfire BBS. For other BBS types, the best choice is probably
  1364.       DATABASE INTERNAL. The reason for this is that most BBS types do not
  1365.       read back SFFILE.DAT. So even though SF-ROM updates the number of
  1366.       files/bytes downloaded in SFFILE.DAT, this information is not saved
  1367.       by the BBS. The caller can re-enter the door several times and
  1368.       download several times his daily limit. The solution is to set
  1369.       DATABASE INTERNAL so the downloads today information is read from
  1370.       SFROM.DAT and the proper limits will be enforced. The DATABASE
  1371.       COMBINED command should be used if you want the number of files/bytes
  1372.       downloaded today to be calculated as the SUM of the values in
  1373.       SFFILE.DAT and SFROM.DAT. In this case, if the caller was allowed 10
  1374.       downloads per day in SF-ROM, but had already downloaded 6 files in
  1375.       the BBS, then the caller would only be allowed 4 more files in
  1376.       SF-ROM. If your BBS does not pass the correct number of files/bytes
  1377.       downloaded in SFFILE.DAT then you should use DATABASE INTERNAL if you
  1378.       want to accurately track and limit daily downloads.
  1379.  
  1380.  
  1381.    KEEPUSERDAYS 90
  1382.  
  1383.       Optional. Registered versions only.
  1384.       This is the number of days a user's information is retained in the
  1385.       internal database file SFROM.DAT. If the user does not call again
  1386.       after this number of days, the user info is not erased, but the
  1387.       record space will be made available for use by another caller. When a
  1388.       new caller exits SF-ROM, the first available record which is either
  1389.       old or flagged for delete will be overwritten. If no records are older
  1390.       than KeepUserDays or flagged for delete, then a new record is added
  1391.       to the end of the file. This maintenance of the database is automatic
  1392.       and occurs every time a caller enters SF-ROM. The size of SFROM.DAT
  1393.       will never decrease, but will stabilize at some value where the daily
  1394.       number of new callers roughly equals the number of callers who have
  1395.       not called back within KeepUserDays.
  1396.       Default is 90 days.
  1397.  
  1398.  
  1399.    KEEPREQDAYS 30
  1400.  
  1401.       Optional. Registered versions only.
  1402.       This is the number of days a file request is retained in the request
  1403.       database file SFROM.REQ. If the caller does not download the file
  1404.       within KeepReqDays then the file will be deleted and the request
  1405.       record will be marked DONE. This maintenance is automatic and occurs
  1406.       every time a caller exits SF-ROM. The next time a file is requested,
  1407.       the first available record marked DONE will be used to record the
  1408.       request. If no records are marked DONE, then a new record will be
  1409.       added to the end of the file. The size of SFROM.REQ will never
  1410.       decrease, but will stabilize at some value where the daily number of
  1411.       new requests roughly equals the number of DONE requests.
  1412.       Default is 30 days.
  1413.  
  1414.  
  1415.    LIMIT   10   12   2000
  1416.  
  1417.       Optional. Registered versions only.
  1418.       SF-ROM automatically reads the callers allowable limit of download
  1419.       files/bytes from DAILYLMT.DAT. Some may wish to override these limits
  1420.       and specify special limits for inside SF-ROM only.
  1421.       The 10 is the callers security level.
  1422.       The 12 is the number files allowed per day.
  1423.       The 2000 is the number of kilobytes per day.
  1424.       So callers with a security level of 10 would be allowed
  1425.       12 files totaling up to 2 meg per day.
  1426.       You may also use the word ALL in place of a security level and then
  1427.       the download limit will apply to ALL callers.
  1428.       You can use one line like this for each security level you wish to
  1429.       limit. So if you had security levels of say 10, 20, 30, 40, 50 then
  1430.       your SFROM.MAS might look like this:
  1431.  
  1432.       LIMIT  ALL   12   2000   ( everyone gets 12 files, 2000K )
  1433.       LIMIT   30   14   3000   ( level 30 gets 14 files, 3000K )
  1434.       LIMIT   40   16   4000   ( level 40 gets 16 files, 4000K )
  1435.       LIMIT   50   18   5000   ( level 50 gets 18 files, 5000K )
  1436.  
  1437.       Each limit is tested in the order that they appear in SFROM.CFG. The
  1438.       last limit read that applies to a particular caller will be used. So
  1439.       if you use the ALL command, it should be the first limit specified.
  1440.       In the example above, levels 30, 40, 50 would get the limit defined
  1441.       for their specific level, while all other levels would get the limit
  1442.       defined for ALL.
  1443.  
  1444.       Allowable values are
  1445.       0 to 2000000000 (2 billion) files per day
  1446.       0 to    2000000 (2 million) kilobytes per day.
  1447.  
  1448.       You can also set no limits for all callers using this command:
  1449.  
  1450.       LIMIT  OFF
  1451.  
  1452.  
  1453.    REQLIMIT   10   12   1000
  1454.  
  1455.       Optional. Registered versions only.
  1456.       Works just like the LIMIT command except it limits requests.
  1457.       In the example above, callers with a security level of 10 would
  1458.       be allowed to request up to 12 files per day totaling up to
  1459.       1000 kilobytes (1 megabyte) per day.
  1460.       You may also use the word ALL in place of the security level and then
  1461.       the request limit would apply to ALL callers.
  1462.       Default request limits are the same as the download limits
  1463.       unless request limits are specified using this command.
  1464.       Allowable values are
  1465.       0 to 2000000000 (2 billion) files per day.
  1466.       0 to    2000000 (2 million) kilobytes per day.
  1467.  
  1468.       You can also set no request limits for all callers using this command:
  1469.  
  1470.       REQLIMIT  OFF
  1471.  
  1472.  
  1473.    FILERATIO   10   50
  1474.  
  1475.       Optional. Registered versions only. Sets FILE ratio limits. In the
  1476.       example above, the 10 is the callers security level, and the 50 is
  1477.       the ratio to enforce. You may use one of these commands on a separate
  1478.       line to set a separate ratio for each security level. Or, you may use
  1479.       the word ALL in place of a security level and then the ratio will
  1480.       apply to ALL callers. If the caller's download to upload ratio
  1481.       exceeds this amount, the caller will not be allowed any more
  1482.       downloads in SF-ROM. This ratio is computed after each successful
  1483.       download by dividing the total number of downloaded files by the
  1484.       total number of uploaded files. For computational purposes, 1 upload
  1485.       is used if the caller has 0 uploads. SF-ROM does not alter the
  1486.       callers security level, so if a caller exceeds his ratio in SF-ROM,
  1487.       he may still be able to download in Spitfire. Spitfire does not
  1488.       recalculate ratios or adjust security levels until after the caller's
  1489.       next download in Spitfire.
  1490.       Allowable ratio values are from 1 to 2000000000 (2 billion).
  1491.       Default is no ratio limits.
  1492.  
  1493.  
  1494.    BYTERATIO   10   50
  1495.  
  1496.       Optional. Registered versions only. Sets BYTE ratio limits.
  1497.       Works just like the FileRatio except that the ratio is computed based
  1498.       on the number of downloaded to uploaded bytes. The FileRatio and
  1499.       ByteRatio values are independently enforced and can be set to
  1500.       different ratios if desired.
  1501.       Allowable ratio values are from 1 to 2000000000 (2 billion).
  1502.       Default is no ratio limits.
  1503.  
  1504.  
  1505.    TOTALDOWN ON
  1506.    TOTALDOWN OFF
  1507.  
  1508.       Optional. Registered versions only.
  1509.       Updates the Spitfire global record of how many downloads today. It
  1510.       does this by updating SFSYSTEM.DAT. This is the number of downloads
  1511.       today value seen by callers during logon. If the Spitfire file format
  1512.       for SFSYSTEM.DAT changes in the future, then TotalDown should be set
  1513.       OFF. SF-ROM is known to be compatible with Spitfire 3.3 to 3.51 in
  1514.       this regard. TotalDown is forced OFF in the unregistered version.
  1515.       The default is TotalDown OFF.
  1516.  
  1517.  
  1518.    LOGNAME  C:\SF\CALLERS.TMP
  1519.  
  1520.       Optional. Registered versions only. Gives the name of the caller
  1521.       activity log file. If no logname is specified, the SF-ROM reads the
  1522.       Spitfire home directory from SFFILE.DAT (or equivalent) line 9 and
  1523.       appends the filename CALLERS.TMP. So if no LogName is specified, then
  1524.       SF-ROM will automatically use the correct Spitfire CALLERS.TMP log
  1525.       appropriate to that node.
  1526.  
  1527.  
  1528.    LOG ON
  1529.    LOG OFF
  1530.  
  1531.       Optional. Registered versions only. Choose one.
  1532.       Turns caller activity log ON or OFF.
  1533.       In unregistered versions the log is forced OFF.
  1534.       In registered versions the default is Log ON.
  1535.       In local mode from the DOS command line the log is always forced OFF.
  1536.  
  1537.  
  1538.    STYLE 1
  1539.    STYLE 2
  1540.    STYLE 3
  1541.  
  1542.       Optional. Registered versions only.
  1543.       Choose one of the style commands shown above. Determines the style of
  1544.       the download line in the caller activity log. Some third party
  1545.       utility programs read the callers log and count or log downloads.
  1546.       These programs require certain download log entry styles which are
  1547.       similar to those created by a normal Spitfire download.
  1548.  
  1549.       Three styles are now offered. More will be added if requested. Only
  1550.       one style may be used in each configuration file. If multiple styles
  1551.       are specified, then the last one specified is used.
  1552.  
  1553.       For Style 1 a typical log entry looks like this:
  1554.       1800LIST.TXT    2,276  Listing Of 1-800 BBS Systems
  1555.       This is the default style and is the same as all previous
  1556.       versions of SF-Rom.
  1557.  
  1558.       For Style 2 a typical log entry looks like this:
  1559.       Downloaded E:\MODEM\800LIST.TXT
  1560.       Note that this is the path to the file on the CD-ROM.
  1561.  
  1562.       For Style 3 a typical log entry looks like this:
  1563.       Downloaded C:\SF\CDROM1\800LIST.TXT
  1564.       Note that this is the file name appended to the path
  1565.       to the file list that contains the file.
  1566.  
  1567.  
  1568.    LOGLEADER  '        '
  1569.  
  1570.       Optional. Registered versions only.
  1571.       This string of characters between the apostrophes '' is placed in
  1572.       front of each caller activity log entry. The default is 8 spaces as
  1573.       shown above and is designed to match the normal Spitfire caller log.
  1574.  
  1575.  
  1576.    INDENTLOG 2
  1577.  
  1578.       Optional. Registered versions only.
  1579.       This is the number of characters each line of the caller activity log
  1580.       will be shifted to the right beyond the amount specified by
  1581.       LogLeader. The line with the caller name (optional, see below)
  1582.       is NOT shifted.
  1583.       The default is 2 as shown above.
  1584.  
  1585.  
  1586.    LOGUSERNAME OFF
  1587.    LOGUSERNAME ON
  1588.  
  1589.       Optional. Registered versions only.
  1590.       If ON, then SF-ROM writes the caller's name to the caller log.
  1591.       Some may wish to turn this ON if the BBS software does not write the
  1592.       callers name to the same log.
  1593.       Default is OFF.
  1594.  
  1595.  
  1596.    BEFOREBAT COMMENT.BAT
  1597.  
  1598.       Optional. Registered versions only. This batch file is run after the
  1599.       files are copied to the hard drive, but BEFORE the download. I use it
  1600.       to insert a BBS advertisement into each ZIP file, but you can use it
  1601.       for anything you like. See supplied sample file COMMENT.BAT. In the
  1602.       example above, COMMENT.BAT is in the current directory, but a full
  1603.       path and file name may also be specified. Send me any good working
  1604.       batch file you write and I will make it available to other SF-ROM
  1605.       users.
  1606.       The following DOS variable parameters are passed for use by the
  1607.       batch file:
  1608.       %1  The directory on the hard drive where the files are copied to.
  1609.           There is no tailing backslash.  Example:  %1 = C:\CDROM\HOLD
  1610.       %2  The callers connect speed.  Example: %2 = 14400
  1611.       %3  The port number.  Example %3 = 2
  1612.           If you are using a non-standard port where you have changed the
  1613.           IRQ number or IO base address, then %3 will be the base address
  1614.           followed by a comma followed by the IRQ number. This is the same
  1615.           as used by DSZmodem for non-standard ports.
  1616.           Example:  %3 = 3e8,4   if you are using address 3e8 and IRQ 4.
  1617.       %4  The full path and file name of the list of files being
  1618.           downloaded. This is the holding directory followed by EXT1.LST
  1619.           where the 1 represents the node number as passed on line 4 of
  1620.           SFFILE.DAT. If your holding directory is C:\CDROM\HOLD and you are
  1621.           using node 1 then %4 = C:\CDROM\HOLD\EXT1.LST. This same file
  1622.           name is passed to DSZmodem to tell it which files to download
  1623.           when the caller is using Y or Zmodem. If the caller is using
  1624.           Xmodem, then this list is not created.
  1625.       Note that if you use a separate holding directory for each node, then
  1626.       only the files being downloaded by the caller will be in this
  1627.       directory. So the batch file can do something to each of the files in
  1628.       this directory. Here is an example, which is the same as in the
  1629.       supplied example file COMMENT.BAT:
  1630.  
  1631.       ZIPCOM  COMMENT.TXT  %1\*.ZIP
  1632.  
  1633.       This puts the BBS advertisement in file COMMENT.TXT into every ZIP
  1634.       file in the holding directory specified by %1. It uses the included
  1635.       free ZipCom program by Mike Robinson to insert the comment.
  1636.       See ZIPCOM.DOC for more info on this program.
  1637.  
  1638.  
  1639.    AFTERBAT YOURFILE.BAT
  1640.  
  1641.       Optional. Registered versions only. This batch file is run just AFTER
  1642.       a download. It is run before the files are erased from the hard
  1643.       drive. You may use this for any purpose. Perhaps some kind of logging
  1644.       function or a bulletin maker could be executed here. In the example
  1645.       above, YOURFILE.BAT is in the current directory, but a full path and
  1646.       file name may also be specified. Send me any good working batch file
  1647.       you write and I will make it available to other SF-ROM users. The
  1648.       same set of DOS variable parameters passed to BeforeBat (see above)
  1649.       is also passed to AfterBat.
  1650.  
  1651.  
  1652.    DIRECTVIDEO ON
  1653.    DIRECTVIDEO OFF
  1654.  
  1655.       Optional. Choose one. With DirectVideo ON, all local screen writes
  1656.       will done directly to video memory instead of through the BIOS.
  1657.       Default is DirectVideo ON which seems to work fine on most systems.
  1658.  
  1659.  
  1660.    CHECKSNOW ON
  1661.    CHECKSNOW OFF
  1662.  
  1663.       Optional. Choose one. CheckSnow ON enables "snow checking" when using
  1664.       DirectVideo ON. It has no effect if DirectVideo OFF. Some older CGA
  1665.       monitors may requires this. It should not be a problem on most
  1666.       monochrome, EGA or VGA video systems. Some systems may run a bit
  1667.       faster with CheckSnow OFF.
  1668.       Default is CheckSnow OFF.
  1669.  
  1670.  
  1671.    BIOSSCROLL ON
  1672.    BIOSSCROLL OFF
  1673.  
  1674.       Optional. Choose one. If BiosScroll OFF, then a special scrolling
  1675.       routine is used that suppresses snow and flicker on systems with any
  1676.       kind of color graphics. However, BiosScroll ON is a bit faster.
  1677.       Default is BiosScroll ON.
  1678.  
  1679.  
  1680.    MAXBUFF 64000
  1681.  
  1682.       Optional. Determines the maximum file copy buffer size in bytes. Most
  1683.       systems work well with the default value of 64000 bytes. This is the
  1684.       maximum buffer size. The actual buffer is created just before copying
  1685.       a file and is sized to fit within the DOS conventional (low) memory
  1686.       available at that moment. Some networks, CD-ROM drives, and CD-ROM
  1687.       software drivers may give better performance if you reduce the
  1688.       MaxBuff. If you are experiencing a problem when the door copies large
  1689.       files, then try reducing the MaxBuff to 32000 or 16000 bytes. The
  1690.       smaller buffer may be a better match with the other CD-ROM related
  1691.       buffers used in your system.
  1692.       Values from 500 to 65500 bytes are allowed.
  1693.       Default is 64000 bytes.
  1694.  
  1695.  
  1696.    MAXQ 20
  1697.  
  1698.       Optional. Determines the maximum number of files that can be entered
  1699.       at one time in the queue used for downloading, requesting, or copying
  1700.       files.
  1701.       Values from 1 to 20 files are allowed.
  1702.       Default is 20 files.
  1703.  
  1704.  
  1705.    LOCKPORT 19200
  1706.  
  1707.       Optional. Do not use this command unless you are sure you need it.
  1708.       SF-ROM will automatically read the hardware to determine the port
  1709.       speed to use. Use of this command overrides the automatic speed
  1710.       detection and forces the port to open at the speed indicated.
  1711.       SF-ROM will attempt to restore the port to it's original speed and
  1712.       state just before SF-ROM halts and returns control to the BBS.
  1713.       Valid port speeds are: 300, 1200, 2400, 4800, 9600, 19200, 38400,
  1714.       57600, 115200.
  1715.  
  1716.  
  1717.    HANDSHAKE ha cts
  1718.  
  1719.       Optional. This command only applies to external protocols. Sets DSZ
  1720.       external protocol to use CTS hardware handshaking flow control. Note
  1721.       that the command ha cts must be all lowercase since DSZ is case
  1722.       sensitive on virtually all commands.
  1723.  
  1724.  
  1725.    HARDFLOW  ON
  1726.  
  1727.       Optional. Do not use this command unless you are sure you need it.
  1728.       Set HardFlow OFF to turn OFF hardware flow control (RTS/CTS) in
  1729.       SF-ROM itself. In general, you should leave HardFlow ON. Most modern
  1730.       modems support hardware flow control. If your com port is running
  1731.       faster than your modem link connect rate, then you must use some
  1732.       sort of flow control. Hardware flow control is almost always the
  1733.       best choice, especially for port speeds of 9600 bps or more.
  1734.       Default is HardFlow ON.
  1735.  
  1736.  
  1737.    SOFTFLOW  OFF
  1738.  
  1739.       Optional. Do not use this command unless you are sure you need it.
  1740.       Set SoftFlow ON to turn on software flow control (XON/XOFF) in SF-ROM
  1741.       itself. In general, Hardware flow control (RTS/CTS) is much better,
  1742.       and most modern modems support it. Software flow control will
  1743.       probably not work very well on a high speed modem. If you use
  1744.       software flow control, please send me a note. I am curious if anyone
  1745.       uses it. It is possible to turn on both hardware and software flow
  1746.       control, but this is not recommended. Default is SoftFlow OFF.
  1747.  
  1748.  
  1749.    FORCECOMPORT 2
  1750.  
  1751.       Optional. Do not use this command unless you are sure you need it.
  1752.       Com port selection is fully automatic based on the value passed by
  1753.       SFFILE.DAT. So SF-ROM uses the same com port used by the Spitfire
  1754.       node. Use of this command overrides this value and forces use of the
  1755.       specified com port.
  1756.       Allowable for this command is 1 to 8.
  1757.       Use in SFROM.MAS if running multi-disk  mode.
  1758.       Use in SFROM.CFG if running single-disk mode.
  1759.       If specified in both, only the value in SFROM.MAS is used.
  1760.  
  1761.  
  1762.    FORCEBASE $02F8
  1763.  
  1764.       Optional. Do not use this command unless you are sure you need it.
  1765.       The I/O port base address selection is fully automatic based on the
  1766.       value in the Spitfire SFNODE.DAT file. So SF-ROM uses the same I/O
  1767.       address as that configured for the Spitfire node. Use of this command
  1768.       overrides this value and forces use of the specified I/O port base
  1769.       address. The $ indicates that the address is specified as a
  1770.       hexadecimal number.
  1771.       Allowable for this command is any value from $0000 to $FFFF.
  1772.       Please note that no checking is done on this value and it
  1773.       is entirely possible to specify a non-existent base address.
  1774.       Use in SFROM.MAS if running multi-disk  mode.
  1775.       Use in SFROM.CFG if running single-disk mode.
  1776.       If specified in both, only the value in SFROM.MAS is used.
  1777.  
  1778.  
  1779.    FORCEIRQ 3
  1780.  
  1781.       Optional. Do not use this command unless you are sure you need it.
  1782.       The IRQ number selection is fully automatic based on the value in the
  1783.       Spitfire SFNODE.DAT file. So SF-ROM uses the same IRQ number as that
  1784.       configured for the Spitfire node. Use of this command overrides this
  1785.       value and forces use of the specified IRQ number.
  1786.       Allowable for this command is any value from 0 to 15.
  1787.       Use in SFROM.MAS if running multi-disk  mode.
  1788.       Use in SFROM.CFG if running single-disk mode.
  1789.       If specified in both, only the value in SFROM.MAS is used.
  1790.  
  1791. ----- DISPLAY FILES -----------------------------------------------------
  1792.  
  1793.       In multi-disk mode, you can optionally set AutoMenu OFF and then the
  1794.       following display files may be used to show the list of available
  1795.       disks:
  1796.  
  1797.       ANSI                  ASCII
  1798.       -----------           -----------
  1799.       MAINxxx.CLR           MAINxxx.BBS
  1800.       MAINxxx.BBS           MAIN.BBS
  1801.       MAIN.CLR
  1802.       MAIN.BBS
  1803.  
  1804.       The "xxx" shown above represents a security level. For example,
  1805.       MAIN10.CLR is the ANSI menu for security level 10. SF-ROM searches
  1806.       for the display files in the order indicated above. If specific
  1807.       display files are not found for the caller's security level, then the
  1808.       general MAIN.CLR/BBS files are shown.
  1809.  
  1810.       In both single-disk mode and multi-disk mode, the following display
  1811.       files may be used to show the list of available file areas on a
  1812.       specific disk:
  1813.  
  1814.       ANSI                  ASCII
  1815.       -----------           -----------
  1816.       DISKxxx.CLR           DISKxxx.BBS
  1817.       DISKxxx.BBS           DISK.BBS
  1818.       DISK.CLR
  1819.       DISK.BBS
  1820.  
  1821.       The "xxx" shown above represents a security level. For example,
  1822.       DISK150.BBS is the ASCII menu for security level 150. SF-ROM
  1823.       searches for the display files in the order indicated above.
  1824.       If specific display files are not found for the caller's
  1825.       security level, then the general DISK.CLR/BBS files are shown.
  1826.  
  1827.  
  1828.       - MULTI-PAGE MENUS -
  1829.  
  1830.       You can also create a multi-page MAIN.CLR/BBS and/or DISK.CLR/BBS. In
  1831.       this case, put all the pages in one file. The door will pause at the
  1832.       end of each page and allow the caller to select a command or scroll
  1833.       to the next page. The number of lines shown is set by the
  1834.       LinesPerPage command.
  1835.  
  1836.       A good method for creating multi-page ANSI menus is to create each
  1837.       page separately in an ANSI editor such as TheDraw. Then use the DOS
  1838.       COPY command to join the screens like this:
  1839.  
  1840.       COPY  PAGE1.CLR+PAGE2.CLR+PAGE3.CLR  ALLPAGES.CLR
  1841.  
  1842.  
  1843.       - CUSTOM WELCOME and GOODBYE SCREENS -
  1844.  
  1845.       Optional. Place these screens in the SF-ROM home directory.
  1846.       If they exist, they will be displayed to the caller.
  1847.       If registered, WELCOME.CLR or WELCOME.BBS will be displayed prior to
  1848.       entering SF-ROM. GOODBYE.CLR or GOODBYE.BBS will be displayed after a
  1849.       download if the caller selects log off after transfer.
  1850.       The .CLR file will be shown if the caller is in ANSI graphics mode.
  1851.       The .BBS file will be shown if the caller is in ASCII graphics mode.
  1852.  
  1853.  
  1854. ----- LOCAL KEYBOARD CONTROLS -------------------------------------------
  1855.  
  1856.       ALT C --- Chat Mode On/Off
  1857.       ALT D --- Drop To DOS (local sysop only)
  1858.       ALT J --- Drop To DOS (local sysop only)
  1859.       F6 ------ Take Five Minutes From Caller
  1860.       F7 ------ Give Five Minutes To Caller
  1861.       F10 ----- Exit The Door
  1862.       ALT F1 -- Exit The Door
  1863.       ALT F2 -- Exit The Door
  1864.       ALT K --- Kill. Throw the caller off the BBS *NOW*
  1865.  
  1866.  
  1867. ----- STATUS SCREENS ----------------------------------------------------
  1868.  
  1869.       The status information shown on the local monitor varies according
  1870.       to the mode and comm driver in use:
  1871.  
  1872. For DOS Local Mode:
  1873. DOS Local Mode              Sunday  January 14, 1996                     12:00pm
  1874. SF-ROM 2.20      For Any BBS - Uart, Fossil, or DigiBoard.   Mem Available: 258K
  1875.  
  1876. For Local Mode in the BBS:
  1877. Michael Robinson     Shelton CT     203-922-1794     3/10     Sec:10      60 Min
  1878. SF-ROM 2.20                           Node:1                                258K
  1879.  
  1880. Online Mode - DigiBoard:
  1881. Michael Robinson     Shelton CT     203-922-1794     3/10     Sec:10      60 Min
  1882. SF-ROM 2.20          DIGIBOARD      Com2      Node:1      14400E            258K
  1883.  
  1884. Online Mode - Fossil:
  1885. Michael Robinson     Shelton CT     203-922-1794     3/10     Sec:10      60 Min
  1886. SF-ROM 2.20             FOSSIL      Com2      Node:1      14400E            258K
  1887.  
  1888. Online Mode - Uart:
  1889. Michael Robinson     Shelton CT     203-922-1794     3/10     Sec:10      60 Min
  1890. SF-ROM 2.20       16550A UART  COM2  Node:1  38400/14400E  IRQ:3  IO:02F8   258K
  1891.  
  1892. Online Mode - when in a particular disk
  1893. Michael Robinson     Shelton CT     203-922-1794     3/10     Sec:10      60 Min
  1894. Night Owl 18 - Online                       COM2   Node:1    38400/14400E   258K
  1895.  
  1896.       Michael Robinson --- Caller name.
  1897.       Shelton CT --------- Caller address.
  1898.       203-922-1794 ------- Caller phone number.
  1899.       3/10 --------------- The caller has downloaded 3 files.
  1900.                            The caller is allowed to download up to 10 files.
  1901.       Sec:10 ------------- Caller security level number is 10.
  1902.       60 Min ------------- The number of minutes caller has left in door.
  1903.  
  1904.       SF-ROM 2.20 -------- Program name and version number.
  1905.       16550A ------------- UART type detected.
  1906.       UART --------------- UART comm driver in use.
  1907.       FOSSIL ------------- FOSSIL comm driver in use.
  1908.       DIGIBOARD ---------- DigiBoard comm driver in use.
  1909.  
  1910.       COM2 --------------- The Com port number.
  1911.       Node:1 ------------- The BBS node number.
  1912.       38400/14400E ------- Port speed / Caller connect speed.
  1913.                            Caller connect speed has E if error correction.
  1914.       IRQ:3 -------------- Interrupt number.
  1915.       IO:02F8 ------------ IO port base address as a hexadecimal number.
  1916.       258K --------------- Current memory available after loading SF-ROM.
  1917.  
  1918.       Night Owl 18 - The current CD-ROM disk name.
  1919.       Online ------- The current CD-ROM disk status is Online.
  1920.       OffLine ------ The current CD-ROM disk status is OffLine.
  1921.       Request ------ The current CD-ROM disk status is Requests Allowed.
  1922.  
  1923.       The UART type, port speed, IRQ, and IO address are not displayed
  1924.       when using the Fossil or DigiBoard comm drivers.
  1925.  
  1926.       Here is a typical set of status information that is displayed on the
  1927.       top of the local monitor during a download:
  1928.  
  1929. Download Today.........3  Download KByte Today.......350   BBS Logon: 8:15 pm
  1930. Download Limit........10  Download KByte Limit......2000  Enter Door: 8:21 pm
  1931. Download Total........27  Download KByte Total..... 4512    Begin DL: 8:33 pm
  1932.   Upload Total.........5    Upload KByte Total......1050   Time Left: 33 min
  1933.  
  1934.  
  1935. ----- TROUBLESHOOTING AND GETTING HELP ----------------------------------
  1936.  
  1937.       First, check the included SF-HELP.TXT file. Many common problems
  1938.       and solutions are discussed there.
  1939.  
  1940.       SF-ROM writes error conditions to file ERROR.LOG in the current
  1941.       directory. Check this file. If it says that SF-ROM cannot find or
  1942.       read a certain file, check your SFROM.MAS, SFROM.CFG, and batch files
  1943.       to locate where this file is specified. Change the path to the file
  1944.       or relocate the file. Make sure you set Debug ON (the default) so
  1945.       that errors are written to ERROR.LOG. If you are having problems with
  1946.       disk volume label sensing, set DebugVol ON.
  1947.  
  1948.       If you use a Fossil or DigiBoard driver, make sure it is properly
  1949.       loaded in memory and activated before running SF-ROM. Check the
  1950.       local monitor status line to see if the comm driver used by SF-ROM
  1951.       is the driver you set in SFROM.MAS.
  1952.  
  1953.       SF-ROM should work OK with multiport IO cards that use a shared IRQ.
  1954.       For an intelligent DigiBoard (or compatible) set Driver DigiBoard.
  1955.       All other multiport IO cards should use Driver Uart.
  1956.  
  1957.       The most common problem is a failure to open the com port. If you see
  1958.       SF-ROM appear on the local screen, but see nothing on the remote end,
  1959.       then you are using the wrong port, the wrong SF-ROM comm Driver, the
  1960.       selected comm driver is not loaded in memory, or you have a
  1961.       non-standard port. See the included file SF-HELP.TXT for more
  1962.       information on solving this problem.
  1963.  
  1964.       If you have checked the files above and are still experiencing
  1965.       problems, then please pack the following files into one ZIP file and
  1966.       upload it to my BBS:
  1967.  
  1968.       1. A text file describing the problem.
  1969.       2. Any ERROR.LOG files created by SF-ROM.
  1970.       3. SFROM.MAS and SFROM.CFG
  1971.       4. The batch file that runs SF-ROM.
  1972.       5. SFFILE.DAT or equivalent
  1973.  
  1974.       Sending the problem description as a text file will save you online
  1975.       time and phone charges. It also helps me to have the problem
  1976.       description and related files all in one neat package.
  1977.  
  1978.       I will post a reply message on my BBS for you within 24 hours.
  1979.       FidoNet nodes may netmail the same information, and I will reply via
  1980.       direct netmail. I fully support both registered and unregistered
  1981.       versions. This program runs well on hundreds of systems, and I will
  1982.       work with you to get it working on your BBS. I recently opened node 2
  1983.       (203-922-1794  FidoNet 1:141/486) which is dedicated exclusively to
  1984.       handling support for my shareware. Traffic on this node is very
  1985.       light, and it is almost always ready and waiting for callers.
  1986.  
  1987.  
  1988. ------- REGISTRATION ------------------------------------------------------
  1989.  
  1990.       This program is SHAREWARE. It represents hundreds of hours of effort.
  1991.       I have been adding features and improving it for almost 4 years now.
  1992.       All upgrades have been free. The registration fee is only $30 which
  1993.       I believe to be a fair price for a program of this caliber.
  1994.       Registration is also sort of an investment in the future of SF-ROM.
  1995.       If people continue to register, I will continue to issue free
  1996.       improvements and upgrades.
  1997.  
  1998.       You may use this program for a free 30 day trial period. After that,
  1999.       you must register it or stop using it. You may give away free copies
  2000.       of this entire unmodified package, but you may not sell it. I retain
  2001.       all rights to this program.
  2002.  
  2003.       As an incentive to encourage registration, the following features are
  2004.       ONLY AVAILABLE IN THE REGISTERED VERSION:
  2005.  
  2006.       ■ The *** UNREGISTERED ***  message on the first screen is replaced
  2007.         by your name and your BBS Name.
  2008.  
  2009.       ■ Requests from offline disks feature is activated.
  2010.  
  2011.       ■ Internal download/request database is activated.
  2012.         Allows SF-ROM to accurately track and limit downloads on ANY BBS.
  2013.         In the unregistered version, only the caller's daily time limit is
  2014.         enforced. In the unregistered version, downloads are not recorded
  2015.         and file/byte per day limits are not enforced.
  2016.  
  2017.       ■ Batch files are called before and after a download to allow
  2018.         insertion of BBS advertisements into ZIP files or any other
  2019.         function you can execute from a batch file.
  2020.  
  2021.       ■ External protocols (optional) using DSZ are activated. Only the
  2022.         internal protocols are available in the unregistered version.
  2023.  
  2024.       ■ WELCOME.CLR or WELCOME.BBS file will be displayed (optional).
  2025.  
  2026.       ■ Full logging of all caller activities. You can log activities to
  2027.         your BBS log, or to a separate SF-ROM log.
  2028.         In the unregistered version, only error conditions are logged.
  2029.         No caller activity log is created in the unregistered version.
  2030.  
  2031.       HOW TO REGISTER:
  2032.  
  2033.       Please fill out and mail the registration form in file REGISTER.DOC.
  2034.       The form is also included below in this file.
  2035.       Or call my BBS for fast online registration using your credit card.
  2036.       I accept Visa, Mastercard, Carte Blanche, Diners' Club.
  2037.       Call The Soft Parade BBS at:  203-922-1794  or  203-924-5603
  2038.  
  2039.       You can also register on CompuServe using GO SWREG and selecting
  2040.       registration of program number 6581. The charge will be added to your
  2041.       CompuServe bill.
  2042.  
  2043.       I fully support both registered and unregistered versions. Node 2
  2044.       (203-922-1794  FidoNet 1:141/486) is dedicated exclusively to
  2045.       handling support for my shareware. Traffic on this node is very
  2046.       light, and it is almost always ready and waiting for callers.
  2047.  
  2048.       You can also reach me on the Internet, CompuServe, or America Online.
  2049.  
  2050.       CompuServe ....... 102363.2051
  2051.       America Online ... TheMikeRob
  2052.       Internet ......... TheMikeRob@aol.com
  2053.  
  2054.       Registered Sysops are entitled to free program support, and free
  2055.       access to all files and features on my BBS. Support is available from
  2056.       me on my BBS, in FidoNet (Wildcat, PCBoard, or Spitfire echos), via
  2057.       direct FidoNet crash netmail, Internet, CompuServe, or America
  2058.       Online.
  2059.  
  2060.       When you register, you will receive a customized personal
  2061.       registration key file and instruction file. The key file activates
  2062.       the registered features in the shareware version, so there will be no
  2063.       need to download any specially compiled versions of the executable
  2064.       program itself. All upgrades have been free to all registered users
  2065.       and I intend to continue this policy.
  2066.  
  2067.       Please be sure to specify your name and your BBS name exactly as you
  2068.       would like them to appear on the first door screen.
  2069.  
  2070.       ---------------------------------------------------------
  2071.       ---------------------------------------------------------
  2072.       ---------------------------------------------------------
  2073.  
  2074.       ---------- SF-ROM 2.20 Door REGISTRATION FORM -----------
  2075.  
  2076.       Your Name: ______________________________________________
  2077.  
  2078.       BBS Name:  ______________________________________________
  2079.  
  2080.       Address:   ______________________________________________
  2081.  
  2082.       Address:   ______________________________________________
  2083.  
  2084.       BBS Phone Number or FidoNet address: ____________________
  2085.  
  2086.       Please answer the following if you want to charge your registration:
  2087.       Credit Card Type: _____________________
  2088.       Name as it appears on the card: _______________________________
  2089.       Credit Card Number: ___________________________________________
  2090.       Expiration Date: _______  Signature: __________________________
  2091.  
  2092.       Please choose ONE of the following registration options:
  2093.  
  2094.       ___ $30 (Thirty Dollars)
  2095.           Call Mike Robinson's BBS and download your registration file.
  2096.           I will establish an account for you in advance if you give the
  2097.           following logon information:
  2098.  
  2099.           Password to use on  Mike Robinson's BBS: _____________________
  2100.  
  2101.           BirthDate to use on Mike Robinson's BBS: _____________________
  2102.  
  2103.       ___ $35 (Thirty Five Dollars) - First Class Mail anywhere in the world.
  2104.           I will mail your registration to you. Specify floppy disk type.
  2105.           3.5 inch HD will be used if not otherwise specified.
  2106.  
  2107.       ___ $35 (Thirty Five Dollars) USA and CANADA ONLY.
  2108.           I will call your BBS and upload your registration to you or
  2109.           I will NetMail your registration to your FidoNet address.
  2110.  
  2111.       ---------------------------------------------------------
  2112.       ---------------------------------------------------------
  2113.       ---------------------------------------------------------
  2114.  
  2115.       Send this form and payment in US DOLLARS to:
  2116.  
  2117.           MICHAEL ROBINSON
  2118.           PO BOX 831
  2119.           SHELTON, CT. 06484-4386
  2120.  
  2121.       Or call either BBS node for fast online registration using
  2122.       your credit card.
  2123.  
  2124.       I accept Visa, Mastercard, Diners' Club, Carte Blanche, personal
  2125.       check, bank check, or money orders. Checks must be from a bank or
  2126.       financial institution with a cashing address within the USA listed on
  2127.       the front of the check. Most major banks in other countries can issue
  2128.       such an international money order or international bank check.
  2129.  
  2130.       Legal Stuff:
  2131.       Use this program at your own risk. No guarantees of any sort.
  2132.       Modification of executable files is prohibited.
  2133.       File sharing and locking implemented via BCSHARE Beta Version 0.7
  2134.       Copyright (C) 1990 - 1994 by Mike Woltz, Buffalo Creek Software.
  2135.       DSZ program Copyright by Omen Technology Inc.
  2136.  
  2137.       Please register your shareware. Authors need your support.
  2138.  
  2139.       SF-ROM Revision History
  2140.       Version 1.00 --- May 31, 1992 - Initial Public Release
  2141.       Version 1.10 --- Sep 05, 1992 - Added batch downloads & file tagging.
  2142.       Version 1.15 --- Oct 10, 1992 - Various bug fixes and test versions.
  2143.       Version 1.20 --- Mar  7, 1993 - Multiple disk support. Enhancements.
  2144.       Version 1.20R--- Nov  8, 1993 - 34 line SFFILE.DAT.
  2145.       Version 1.30 --- Jan 31, 1994 - Offline requests, database, ZIP files.
  2146.       Version 1.30h--- Apr  2, 1994 - Various bug fixes and test versions.
  2147.       Version 1.30i--- Oct  8, 1994 - Multi-tagging, Spitfire 3.5.
  2148.       Version 2.00 --- Nov 27, 1994 - Internal protocols, Fossil, DigiBoard.
  2149.       Version 2.10 --- May 31, 1995 - AutoMenu, Disk Detect, List Maker.
  2150.       Version 2.20 --- Jan 14, 1996 - Spitfire 3.51. Disk detect enhance.
  2151.  
  2152.       Each of these was a FREE upgrade to all registered users.
  2153.  
  2154.       *******************************************************************
  2155.  
  2156.       OTHER PROGRAMS BY MIKE ROBINSON:
  2157.  
  2158.       * Multi-Call Callback Verify Door for any BBS *
  2159.       Multi-CALL is a callback verify door for any DOS BBS that creates
  2160.       DOOR.SYS, DORINFOx.DEF, SFDOORS.DAT. It supports a plain UART, FOSSIL
  2161.       driver, or DigiBoard. It drops carrier and then calls the user back.
  2162.       It can then increase the caller security level and/or increase the
  2163.       time online. DIRECT SUPPORT (read and write) for the following BBS
  2164.       types: Wildcat 3.x & 4.x, PCBoard, Spitfire, RemoteAccess, ProBoard,
  2165.       Maximus 2.x & 3.x, TAG, TriBBS All screens/messages/prompts can be
  2166.       customized for any language. Flexible phone number format for use in
  2167.       any country. Allow or disallow long-distance calls. Limit access by
  2168.       phone number, calls per day, time of day, and security level.
  2169.       Optional hangup after callback. Special support for Wildcat and
  2170.       Maximus word style security level names such as LIMITED, SYSOP, etc.
  2171.       Writes to 4 different log files: BBS log, MultiCall log, log of calls
  2172.       today, and log of all good callbacks. Optional "fake mode" for
  2173.       instant verify without callback. Optional dial number translations
  2174.       for special situations.  Fast online registration is only $25.
  2175.  
  2176.       * Multi-Menu Door for any BBS *
  2177.       MultiMenu is a menu extension door for any BBS that creates a
  2178.       DOOR.SYS, DORINFOx.DEF, or SFDOORS.DAT door drop file. It uses either
  2179.       a plain UART, FOSSIL driver, or DigiBoard Driver. It will work on
  2180.       multi-port IO cards that utilize a shared IRQ. Up to 254 doors,
  2181.       access control by security/age/baud/password, automatic display
  2182.       generation, custom display screens, Ansi/Ascii graphics, optional
  2183.       status line, port speed up to 115,200 bps, DESQview aware,
  2184.       multi-node and network support, file sharing and locking, chat mode,
  2185.       local drop to Dos, carrier detect, inactivity timeout, activity log.
  2186.       Very easy to setup. Can run in local mode in the BBS or from the DOS
  2187.       command line. MultiMenu exits with an ErrorLevel which is then used
  2188.       in a batch file to pass control to the selected external door or
  2189.       other program.  Fast online registration is only $20.00.
  2190.  
  2191.       * EZ-ROM CD-ROM Door for ANY BBS using DOOR.SYS or DORINFOx.DEF *
  2192.       EZ-ROM is based on the same base source code as SF-ROM. It is
  2193.       designed for use on any BBS that can create the standard door drop
  2194.       file DOOR.SYS or the DORINFOx.DEF door drop file. The configuration,
  2195.       file format, and appearance is exactly the same as SF-ROM. Whenever
  2196.       new features are added, they appear simultaneously in new releases of
  2197.       both SF-ROM and EZ-ROM. The revision numbering scheme is the same so,
  2198.       for example, SF-ROM 2.20 is the equivalent of EZ-ROM 2.20. So if you
  2199.       run Spitfire BBS, get SF-ROM. All other BBS types should use EZ-ROM.
  2200.       Includes special support for PCBoard, Wildcat 3.x & 4.x, ProBoard,
  2201.       RemoteAccess, Maximus 2.x & 3.x, TAG, and TriBBS 10.x. Updates the
  2202.       BBS user database with the number of files/bytes downloaded.
  2203.       Fast online registration is only $30.00.
  2204.  
  2205.       *******************************************************************
  2206.  
  2207.       The latest versions of all my programs can be downloaded from either
  2208.       node of my BBS or any of the following locations:
  2209.  
  2210.       America Online .... Computing, TeleCom Forum, BBS Doors library
  2211.       CompuServe ........ GO PCBBS, BBS Doors
  2212.       Internet .......... users.aol.com  ( directory TheMikeRob/pub )
  2213.       Internet .......... ftp.coast.net  ( directory Simtel/msdos/bbsdoor )
  2214.       Both Internet sites allow anonymous ftp file transfer.
  2215.       The Simtel site is "mirrored" at dozens of sites around the world.
  2216.  
  2217.       The file names are sfromxxx.zip, ezromxxx.zip, mcallxxx.zip,
  2218.       mmenuxxx.zip. The "xxx" symbolizes the version number.
  2219.  
  2220.       You can also REGISTER on CompuServe using GO SWREG number 6581.
  2221.  
  2222.       The Soft Parade BBS - Shelton Connecticut USA
  2223.       Home of the EZ-ROM, SF-ROM, Multi-CALL and Multi-MENU Doors.
  2224.       Node 1  203-924-5603  FidoNet 1:141/485  General Public Access
  2225.       Node 2  203-922-1794  FidoNet 1:141/486  Shareware Support Only
  2226.       File Request SFROM, EZROM, MCALL, MMENU for latest versions.
  2227.       File Request SFROM.NEW, EZROM.NEW, MCALL.NEW, MMENU.NEW text file.
  2228.  
  2229.       Internet ......... TheMikeRob@aol.com
  2230.       America Online ... TheMikeRob
  2231.       CompuServe........ 102363.2051
  2232.  
  2233.       *******************************************************************
  2234.  
  2235.       PKZIP archive security notice for this archive should read:
  2236.       Authentic files Verified!   # FEZ251
  2237.       MICHAEL N. ROBINSON
  2238.  
  2239.